Skip to main content
Leverage schedules to tell us who should be on-call and when. We’ll walk you through all the steps to create schedules that will work for your organization’s needs.

Getting Started

  1. First, head to On-call within the incident.io dashboard
  2. Go to Schedules and create a new schedule
  3. Name your new schedule, set up rotation, and choose the responders who should be in that specific schedule. If you select a team, we’ll add everyone in the team by default.
  4. Preview your schedule and save
Read how to get started with On-call and how to connect your schedules to Alert routes here.

Rotation

Rotations are a great way to have a rolling schedule for your team to be on-call. Set up the times and people you want to work on specific times. There’s an option for Daily, Weekly, or Monthly rotations.
The Rotation settings with Rotates set to Weekly and a shift changeover
banner

Asymmetric schedule

If you are splitting your shifts to be more asymmetric, you can create time intervals within hours days and weeks. By adding a new interval, you can create a rule to have your shifts to work example in 3 and 4 day shifts. If you create shifts that are asymmetric and the amount of shifts is the same as the people in the schedule, we rotate the people to have a balanced amount of time on-call.
Shift rotation set to Custom, changing shift every 3 days then every 4
days

Advanced rotas

Schedules offer a lot of additional customisations that can help with your organization’s specific setup. Advanced rotas allow you to bring multiple rotas to your schedule. For example, in global companies, we often see rotas that support follow-the-sun. Different locations could be on-call during different times during the day which will allow for all day coverage. We’ve mapped out an example below where we have created two rotas: One for the US and one for the UK. The UK team is on-call between 9 am to 8 pm daily and the US team is between 8 pm to 9 am GMT.
The UK rotation tab with responders, Specific times of 09:00 to 20:00, and a custom weekly shift
change
The USA rotation tab with responders and Specific times of 20:00 to
09:00

Add a person multiple times to a rota

You can add multiple people to a rota by just choosing the same person multiple times, we’ll let you know if the person appears more than once!
Responder search for nia, showing Nia Williams marked Appears
twice

Intervals

Intervals are a great tool to use when you have different shifts throughout your week. For example, if some of the teams are only on-call during office hours you can choose specific times for your office hours.
Working hours set to Specific times, Monday to Friday, 09:00 to
17:00

Shadow schedules

When you have new joiners in the team, a great way to get them into the product and schedules is to have a shadow schedule. This way the new joiners can follow alerts and incidents to build more context around your product and get used to being on call. Just add a new rota and name it ‘Shadow Schedule’ and add people and times you want them to shadow alerts and incidents.
The Create a new schedule drawer with four responders, two concurrent shifts, and a shift
preview

Planning changes to a schedule

If you are looking to make changes like…
  • Onboarding or removing responders from a certain date / time
  • Changing the working hours of your schedule
  • Changing the rotation’s interval
  • Any combination of the above
and you want your changes to come into effect from a future date (e.g. from the next shift), you can specify this while editing your schedule. Make all the edits you need, then choose when they take effect:
The When should these changes take effect question set to Later, with Changes effective from a future
date
If you want to change who is on your schedule rotation, we suggest changing the handover time to match the effective time for your rotation to start from scratch. This is because we rotate through shifts based on the handover date, not the effective time. You can use the preview to make sure your changes look right!

Restoring a previous schedule version

If you make a change to a schedule, and then find you need to restore to a previous version, then you can easily do so from the schedule’s drop down menu. You’ll be able to see a preview of the schedule with the version you’re restoring to.
Restoring to a previous version will use the previous version’s config to determine what your schedule shifts look like going forward, but it won’t change historical shifts.
The schedule menu open with Restore previous versions
listed
The Restore previous version drawer comparing the current version against Version 1 and Version
2

Overrides

Sometimes your team member is heading on a holiday or might need to head to a doctor’s appointment. In Schedule overrides you don’t need to change your current schedule or rotations, but can create one time changes to suit any miscellaneous events that happen during the week.
  1. To create an override, click ‘Add override’ and add details
The Create override drawer with a responder, cover times, and a Schedule after override
preview
  1. After you have created the override, you can see and review it on the Schedule’s page and edit it if needed.
A schedule page with Rotas, Overrides and Final schedule sections, and one override on the USA rota You can also manage overrides via the API — creating, updating and deleting them — for example to sync time off from an HR system. To mark that no one should be on call for a period, pass "NOBODY" as the user ID.

Cover me

Cover me allows your team to ask for an override instead of just adding someone in.
  1. Go to your #incidents channel in Slack and type /inc cover me
  1. Choose your shift and choose the times you need cover for
The Request on-call cover Slack modal with an upcoming shift chosen and cover times prefilled
  1. Add more information and Submit!
The Request on-call cover confirmation step with a reason entered and a Submit button Then your team members in the same schedule will receive the request both in the mobile app and Slack A Slack message reading Miia Paavola requested cover for, with Accept and Decline buttons And receive a confirmation if you accept A Slack message confirming You're covering Miia Paavola for, with the shift times

Viewing multiple schedules

From the Schedules page, select View multiple to view up to 10 schedules at once. Your selection is saved in the URL, so you can bookmark the view to return to it later.

Syncing shifts to a calendar

Select Sync calendar on the Schedules page to get a feed of your own shifts, or of everyone’s, and subscribe to it in Google Calendar, Outlook, or any other calendar app. See Sync on-call shifts to your calendar.

FAQs

If you are a responder on the affected schedule with update permissions, or have previously edited it, you will receive a notification whenever someone on that schedule is deactivated (via Slack, Okta, or another provisioning service) or otherwise loses their on-call seat. You are then recommended to update the schedule to ensure you maintain on-call coverage.By default this notification is sent by email. Your organization can also opt in to receiving it as a Slack (or Microsoft Teams) direct message from Settings → On-call → Notifications.If an escalation reaches a deactivated user, we will automatically escalate to the next escalation level. If you run a schedule coverage policy, the gap left by the missing responder is flagged there too.An email titled An on-call responder has been deactivated, listing the affected schedules and escalation paths