Skip to main content
A schedule decides who is notified when an incident occurs and how on-call members hand off. Flashduty On-call supports daily, weekly, and custom rotation cycles, as well as day/night shifts and primary/backup on-call.

Core concepts

Understanding these concepts before configuration will help you better plan your schedules: Schedule Concepts

Configuration process

1

Create a Schedule

Go to Schedule Management, click Create schedule
  • Schedule Name: 1–40 characters, must be unique within the account
  • Owning Team: Specifies which team manages this schedule; team members gain edit permissions for this schedule
  • Schedule Description: Supports Markdown syntax, content can be included in notifications; up to 500 characters
  • Time Zone: Required. Flashduty computes the schedule’s rotations and shifts on the local time of this zone (for example, “handover at 09:00 daily” means 09:00 in the schedule’s own zone). It cannot be changed after creation; to use a different zone, create a new schedule and migrate the dispatch policy references
The schedule list shows a Time Zone column. The roster page labels two zones side by side. “Times on this page are shown in your time zone” is the viewer’s effective zone: the personal time zone, or the organization zone if none is set. The schedule time zone is the zone the shifts are defined in. Times on screen are in the viewer’s zone.
Older schedules created without a time zone use Asia/Shanghai.
The Free plan allows you to create only 1 schedule. Upgrade to the Standard plan or higher to create more.
2

Set Shift Notifications

To prevent forgetting shifts or handoffs, the system provides two notification triggers. You can enable either or both:Scheduled notifications remind who is currently on-call. Flashduty reads the fixed time as local time in the schedule’s time zone. If your time zone differs, a badge next to the time input shows the schedule’s time zone.After enabling either notification trigger, configure notification channels:The Feishu, WeCom, and Zoom bot forms include an Enable @ mentions switch. When it is on, the notification mentions only the people on duty for that notification; the next shift is listed by name without a mention. DingTalk bots always mention people by member phone number and have no switch; Slack and Telegram bots mention no one.For Feishu and Zoom, Enable @ mentions requires a User information mapping, and saving fails with “User information mapping is required” without one. The mapping’s source label takes the member’s registered email, and its target label holds the Feishu user ID or Zoom JID; members with no match are listed by name only. Create and maintain mappings under Configuration → Mappings; Quick create mapping schema below the switch opens the create page for the matching type. Mappings that don’t fit the bot type are greyed out in the dropdown, and if a selected mapping is later changed to an incompatible structure, saving fails with “The selected user information mapping is incompatible. Please select another one.”
When selecting a group chat: disabled IM apps stay in the dropdown, labeled “(Disabled)”, but you can’t select them; re-enable the app in Integrations first. The picker excludes platform-created chats such as war rooms. Stale targets show as Chat unavailable, and you can remove them.
When you choose Follow personal preference, on-call personnel must meet the following prerequisites — otherwise they will not receive notifications even while on shift:
  1. Bind and verify a phone number and email in Personal Center → Profile
  2. Log in through the Flashduty app inside an IM platform (Feishu, DingTalk, WeCom, and so on) and complete account binding
  3. Configure notification preferences in Personal Center → Notification (choose which channels to prioritize)
3

Define On-call Rules

This is the core step. You can add one or more layers of rules. Each layer includes the following fields:The three Time Restriction modes:
  • No restriction: Members are on-call for the entire rotation cycle
  • Daily: Set daily on-call time ranges (for example, 09:00–18:00), multiple periods can be added. Input uses HH:MM format, which cannot express 24:00 — so an end time of 00:00 means end of day, and 00:00–00:00 means on-call for the full day
  • Weekly: Set day+time on-call ranges (for example, Monday 09:00 – Friday 18:00), multiple periods can be added
When date mask is enabled, the “Weekly” restriction mode is unavailable since the date mask already provides day-of-week control. If you enable the date mask while the time restriction is already in “Weekly” mode, the system automatically resets it to “No restriction”.
After setting time restrictions, there may be gaps with no one on-call — ensure other rules provide coverage.

Delete a schedule

You can delete a schedule from the schedule list or the schedule detail page. The system asks for confirmation before deletion.
If escalation rules reference a schedule, its delete button is disabled. Hover over it to see the list of referencing escalation rules (channel → rule name). Remove the references in the corresponding channels before deleting the schedule, so that you don’t miss new incident notifications after deletion.

On-call roles

On-call roles distinguish responders with different responsibilities within the same schedule (for example, “primary” and “backup”) and are an account-level resource:
  • Shared across the account: Roles take effect at the account level and are shared by all schedules
  • Grouped by role inside a rule: When adding personnel to a schedule rule, you can bind members to a specific role, forming a “role → member” mapping
  • Escalation rules target by role: Escalation rules support notifying all on-call personnel, specific roles (for example, notify primary only), or specific members, enabling finer-grained alert routing
By default, each account has only one on-call role, so you don’t need to choose a role when adding responders. If you need multiple roles (such as primary/backup), contact Flashduty support to enable them. Once enabled, you can assign roles to members both in schedule rules and in overrides. Self-service role management is not available in the console.

Override and time off

When on-call personnel need time off or have a temporary conflict, don’t modify permanent rules — use the “Override” feature instead. An override is an independent rule type that fully preempts the normal on-call rules within its effective window. Once the window ends, the original rules resume automatically.

Two ways to create an override

1

Create from the calendar

On the schedule details page, click the time slot you want to adjust in the calendar view, and choose Override. The default window covers the selected day in the schedule’s time zone. You can adjust its start and end times.
2

Create from the override entry

Below the schedule calendar, select Overrides to add an override directly. The adjacent Schedule rules entry adds regular rules.

Configurable fields

Overrides have a smaller field set than regular rules and only include:
  • Start Time / End Time: Define the override window. Defaults to [today 00:00, next day 00:00]
  • Replacement Person: The member who replaces the original on-call person within that window
Overrides do not support rotation cycle, date mask, grouping, or other regular-rule fields. For accounts with multiple on-call roles enabled, you can also assign a role to the replacement person in an override.
Within its time window, an override fully replaces all regular on-call rules (regardless of which layer they belong to), rather than stacking with them. When rules of the same type overlap, the rule lower in the list takes precedence. Non-overlapping periods remain unchanged. Reorder rules to change who is on call during overlaps. Flashduty keeps all override records for later review.

Date mask and continuous rotation

Date mask

Date mask controls which days of the week an on-call rule takes effect. By selecting different day combinations, you can flexibly implement differentiated scheduling between weekdays and weekends. Common use cases:
  • Weekday/weekend separation: Team A on-call during weekdays, Team B on weekends
  • Specific day scheduling: Assign certain personnel only on Monday, Wednesday, and Friday
  • Day/night shift by day: Configure day and night shift rules for weekdays, and full-day on-call rules for weekends

Continuous rotation

By default, Flashduty divides schedules at 00:00 each calendar day and splits a shift that spans midnight into separate segments. Default Rotation When continuous rotation is enabled, Flashduty calculates rotation boundaries from the shift start time instead of the 00:00 cutoff. Each on-call member will complete a full rotation cycle without being split at midnight. Continuous Rotation
Consider enabling continuous rotation in the following scenarios:
  • Rotation cycle is 24 hours
  • Shift start time is not 00:00
  • Day-of-week date mask is configured
  • Different rotation rules for weekdays and weekends

Common scheduling scenarios

Requirement: Ops team has A, B, C—each person on-call for one week, handoff Monday at 10:00 AM.Configuration:
  • Personnel sequence: A, B, C
  • Rotation cycle: 1 week
  • Handoff time: Monday 10:00
Result: A on-call one week → B on-call one week → C on-call one week → A on-call one week…Simple Rotation

View schedule details

Click a schedule name to enter the detail page, where you can view the scheduling calendar and manage on-call rules. The upper right corner provides these options:
  • View switcher: Toggle between “Week”, “Two Weeks”, and “Calendar” (month view)
  • Highlight my shifts: When enabled, the roster highlights your on-call shifts
Click any time slot in the calendar to view the current responders or create an override. The legend below the calendar lists the responders by on-call layer and role, with each member’s readiness in parentheses after the name: On a self-hosted deployment with the phone turned off, only the app status is shown. The parentheses are omitted when readiness can’t be read. Only the subject account and account administrators see other members’ readiness; everyone else sees only their own. Your organization can require a number of high-urgency methods. See Readiness requirement.

View my schedule

The Schedules list page embeds a My Schedule section at the top, with a week view of your on-call assignments. The left column lists schedules where you have shifts this week. The calendar on the right shows your time slots in each schedule. Use the arrows next to the section title to browse other weeks. Click the dot between them to return to the current week. Shift times appear in your effective time zone. If a schedule’s time zone differs from yours, an extra line shows the same slot in the schedule’s time zone.

Escalation Rules

Configure alert notification rules and escalation paths

Service Calendar

Define workdays and rest days