# Create & Manage Schedules in Pagerly

Pagerly lets you **own your on-call schedules directly inside Slack**. Instead of relying on external schedulers, teams can create and manage their rotations, shifts, and overrides within Pagerly.

This section covers how to:

* Create Round Robin schedules
* Create Shift schedules
* Sync Schedule and Oncall to Slack usergorup like @oncall
* Sync schedules to Slack, Google Calendar, and Linear
* Manage Overrides (temporary replacements)
* Handle Multi-Team and Multi-Rotation setups

***

### 🔄 Create Round Robin Schedule

Round Robin schedules distribute on-call duties evenly among team members. Pagerly rotates responsibility automatically, removing the need for manual updates.

***

### ⏰ Create Shift Schedule

Shift schedules assign users to specific time blocks (e.g., day/night, weekday/weekend). This is useful for distributed teams or time-sensitive operations.

#### 📅 Multiple Schedule Types<br>

#### Pagerly supports creating different types of schedules to fit your team’s workflow:

Day-wise – assign daily on-call engineers.

Week-wise – set weekly rotations for fairness.

Month-wise – long rotations for larger teams.

Custom day-wise – tailor schedules to specific weekdays (e.g., Mon/Wed/Fri).

For even more complex requirements, [Pagerly supports AI-generated rotations. Simply provide your team size, preferences, and constraints — Pagerly AI can suggest optimized schedules automatically.](https://docs.pagerly.io/how-to-work-with-pagerly/create-rotations-using-ai)

***

### 🔗 Sync Pagerly Schedules to Other Tools

Once created, Pagerly schedules can sync automatically to external tools:

* **Slack Usergroup** → Keeps a group (e.g., `@oncall`) updated with the current engineer.
* **Google Calendar** → Creates calendar events for visibility.
* **Linear** → Ensures tasks are always assigned to the correct on-call engineer.

***

### 🔄 Manage Overrides (Temporary Replacements)

Overrides allow you to swap one engineer for another in the active schedule. The replacement is reflected across Pagerly, Slack, Google Calendar, and integrations.

***

### 👥 Multi-Team / Multi-Rotation Handling

Pagerly supports multiple teams and complex scheduling:

* Create separate rotations for different teams (e.g., Backend, Infra).
* Escalate incidents across multiple rotations if not acknowledged.<br>

### Follow the following steps to Add Rotation / Shift Schedule in Pagerly

1\. Navigate to <https://workspace.pagerly.io/teams>

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-05-30/ba60d5b3-d1d7-466d-9157-14405628d3a8/ascreenshot.jpeg?tl_px=0,0\&br_px=1528,854\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=194,257)

2\. Click "Add Team"

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-05-30/632f51e1-306f-428a-b1bb-2e4d3955bfc3/ascreenshot.jpeg?tl_px=1689,0\&br_px=2940,699\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=899,193)

3\. Select 'Create Time-wise Round-Robin Schedule' OR 'Oncall Schedule'\
for creating a time based self rotation team.

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-05-30/64f52b4c-a531-431c-bd6a-dadb4728de07/ascreenshot.jpeg?tl_px=974,0\&br_px=2940,1098\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=950,157)

4\. 1. Select to rotate users or usergroups.\
2\. Select rotation frequency.\
3\. Select rotation day. (Can only select multiple days if frequency is set to 'Daily')

{% hint style="warning" %}
For more complex rotations, use Custom Options which create [Rotations using AI.](https://docs.pagerly.io/how-to-work-with-pagerly/create-rotations-using-ai)
{% endhint %}

\
4\. Select time.\
5\. Select timezone.\
6\. Select users to be included in rotation. (Select users or usergroups based on the type of rotation selected in Step 1)

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-05-30/975b8fd0-1afd-4259-8551-161cc9eb5018/ascreenshot.jpeg?tl_px=188,55\&br_px=2940,1594\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=830,305)

5\. Click "Generate Preview" to see a preview of how your rotation will be set.

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-05-30/dbaf7285-9064-416e-b6c5-13ed0cab204e/ascreenshot.jpeg?tl_px=974,468\&br_px=2940,1567\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=649,277)

6\. Rotation preview is generated.

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-05-30/c9a069a3-7de8-487a-a853-980a60dd5840/ascreenshot.jpeg?tl_px=974,392\&br_px=2940,1491\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=715,276)

7\. Click "Next"

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-05-30/bf2309a7-6320-49c5-afb6-f7078914367e/ascreenshot.jpeg?tl_px=974,495\&br_px=2940,1594\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=779,554)

8\.

1.[ Add team name.](#team-name-settings)\
2\. [Add usergroup to mention the current on-call/rotated user (optional).](#usergroup-settings)\
3\. [Add permanent users (optional).](#usergroup-settings)\
4\. [Set automated reply (optional).](#automated-replies)\
5\. [Set the team channel to get rotation updates.](#team-channel)\
6\. [Check the box to receive update notifications.](#team-channel-notifications-and-channel-topic)\
7\. Click the "Save" button.

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-05-30/0c294608-100e-45bd-b679-b34aec3503b8/ascreenshot.jpeg?tl_px=188,55\&br_px=2940,1594\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=875,513)

9\. Team added successfully!

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-05-30/ecb66fe0-5805-4603-9257-b8123c7930f1/ascreenshot.jpeg?tl_px=207,59\&br_px=2172,1158\&force_format=jpeg\&q=100\&width=1120.0\&wat=1\&wat_opacity=0.7\&wat_gravity=northwest\&wat_url=https://colony-recorder.s3.us-west-1.amazonaws.com/images/watermarks/FB923C_standard.png\&wat_pad=524,460)

***

### Each Team has the following properties:

### Team Name Settings

This is your team name and the slack command that would be used to mention the current oncall, fetch oncall schedule, etc. i.e. You can use

* `@Pagerly <team>` : To mention the current oncall on any Slack Thread
* `/schedule <team> : To fetch the team's oncall schedule. You can then manage( view, override ) from Slack itself`<br>

{% hint style="warning" %}
There are some gotchas to keep in mind when selecting the team name :

Single word only: You can only put a single word while choosing the command name. You can combine long names with underscores, hyphens, etc

You can use names like : `dev-on-call , dev, dev_on_call`

* You cannot use names like : `dev on call`, `payments team 2`
* Cannot use the name `help : This is due to slack limitation of keeping help as a reserved keyword . You can use ``@pagerly help`` for help needed in the command`
  {% endhint %}

### Usergroup Settings

With Pagerly you can sync the Oncall Schedule with Slack Usergroup

You can sync with External Schedule like Pagerduty, Opsgenie, Google Calendar etc

You can also sync with Pagerly Round-Robin Schedule

\
**Pagerly would automatically fetch the latest oncall(s) and add the users in the usergroup and remove others**

{% hint style="info" %}
For Usergroup to work : Pagerly App uses Slack's User Group feature to create an @mention for every Please make sure you have it enabled for everyone in the [workspace settings](https://my.slack.com/admin/settings#user_group_restrictions) .
{% endhint %}

<figure><img src="https://296040630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu15pukNExHWOsjYrdZrh%2Fuploads%2Fz6bjijsW2BBXlh77stCn%2FScreenshot%202025-01-16%20at%2012.30.16%20AM.png?alt=media&#x26;token=b4d272a3-dd57-4b08-8b43-c1c44d51f318" alt=""><figcaption></figcaption></figure>

* **Usergroup**: If you want to have a custom command like `@dev-on-call` instead of `@Pagerly dev-on-call` or If you already have a usergroup and you want the current oncall(s) to be automatically added to the usergroup, you can use this property.\
  **Pagerly would automatically fetch the latest oncall(s) and add the users in the usergroup and remove others**
* **Permanent Users in the user group (optional) :** These are the members who you need as permanent members of the usergroup

<figure><img src="https://296040630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu15pukNExHWOsjYrdZrh%2Fuploads%2FEEun8J3PpgnaoDYVFAnt%2FScreenshot%202024-12-09%20at%2010.27.15%20PM.png?alt=media&#x26;token=4b97666c-ce21-4629-bcc6-ba39a84614bd" alt=""><figcaption></figcaption></figure>

### Automated Replies

**Automated Reply:** To add a fixed reply when your oncall is mentioned. Works only with `@Pagerly commands`. You can put SOPs, Troubleshooting docs, etc in automated replies. This would help in saving precious oncall time since some of the queries can be automatically taken care of :moneybag::moneybag:

<figure><img src="https://296040630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu15pukNExHWOsjYrdZrh%2Fuploads%2FjF0WXnR9PaOA99BNaQw6%2F641aa323f6e779791ae656b5_Screenshot%202023-03-22%20at%2012.10.51%20PM-p-500.png?alt=media&#x26;token=63838cef-bd1a-4421-8d84-6ef967173d27" alt=""><figcaption></figcaption></figure>

***

### Team Channel, Notifications and Channel Topic

#### T**eam Channel**

The slack channel which would subscribe for any oncall handover / oncall rotation change. On any change in oncall rotation, you would receive 2 notifications on this slack channel

* **Channel Topic Update** : Your slack channel topic would be automatically updated with the current oncall.\
  It would look something like this 👇🏻
* **Channel Message** : Your channel would receive a notification on the oncall change

([Customize Notification Here](https://docs.pagerly.io/how-to-work-with-pagerly/custom-change-notification-on-slack))👇🏻

<figure><img src="https://296040630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu15pukNExHWOsjYrdZrh%2Fuploads%2FEp1HitE3uiQaxYRnxWSW%2FScreenshot%202023-03-29%20at%2012.46.34%20AM.png?alt=media&#x26;token=0c0e1b6c-bace-4f1c-ac2e-23699bfe6e07" alt=""><figcaption></figcaption></figure>

<figure><img src="https://296040630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu15pukNExHWOsjYrdZrh%2Fuploads%2FGGVt7nCRYrrz6Kwj6j0r%2F641ac2fc5b93f32d8e8b1bef_Screenshot%202023-03-22%20at%202.27.12%20PM-p-800.png?alt=media&#x26;token=8a972b0e-6bee-4731-bd19-f5be4350a241" alt=""><figcaption></figcaption></figure>

#### **Notification && Topic Setting**s

You can choose to receive if you want to receive notifications on oncall/rotation change as well topic updates.

* Update Channel with Topic Name -> If you want your channel topic to be updated with latest oncall
* Show Change Notification on Channel -> If you want to receive the Notification whenever there is a change in oncall / rotation ([Customize Notification Here](https://docs.pagerly.io/how-to-work-with-pagerly/custom-change-notification-on-slack))

<figure><img src="https://296040630-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu15pukNExHWOsjYrdZrh%2Fuploads%2FBDEmzNbXqXbu17XycfSN%2FScreenshot%202024-11-11%20at%204.20.10%20PM.png?alt=media&#x26;token=4b5a5038-49ab-44b9-a953-91d4a7aef091" alt=""><figcaption></figcaption></figure>

\
\
\
The next section would be how to setup the team with all other fields
