> For the complete documentation index, see [llms.txt](https://docs.pagerly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagerly.io/how-to-work-with-pagerly/create-round-robin-rotations/how-to-add-rotation-in-pagerly.md).

# How To Add Rotation in Pagerly

Video Reference

{% embed url="<https://scribehow.com/embed-preview/Creating_self_rotation_team__pdf-Bx2KQ12tARsWWYtpXA?as=video&size=flexible>" %}

### Follow these steps to Add Rotation / Shift / Turn 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' 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\.

4.1. Select to rotate users or usergroups. 4.2. Select rotation frequency. 4.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.](/how-to-work-with-pagerly/create-rotations-using-ai.md)
{% endhint %}

4.4. Set the rotation start and end time (end time is optional; if not provided, a 24-hour rotation is assumed). 4.5. Select timezone. 4.6. Set On-call type as **'Single user on-call'**.

{% hint style="info" %}
For Multi user on-call, check out [Multi User On-call Rotation.](/how-to-work-with-pagerly/create-round-robin-rotations/how-to-add-multi-user-rotation-in-pagerly.md)
{% endhint %}

4.7. Select users to be included in rotation. (Select users or usergroups based on the type of rotation selected in Step 1)

![](https://colony-recorder.s3.amazonaws.com/files/2026-04-09/1089c243-7e81-4f7a-92dc-eb3e1faee53e/ascreenshot_f5fef02152fc43e3a7343de0da92778a_text_export.jpeg)

5\. Click "Generate Preview" and verify the rotation. If satisfied, click "Next".

![](https://colony-recorder.s3.amazonaws.com/files/2026-04-09/270bfdee-375f-4133-a1b6-f222cb217d36/ascreenshot_4341074c8d5e4bebb6fa12fdc89059af_text_export.jpeg)

6\.

6.1.[ Add team name.](#team-name-settings)\
6.2. [Add usergroup to mention the current on-call/rotated user (optional).](#usergroup-settings)\
6.3. [Add permanent users (optional).](#usergroup-settings)\
6.4. [Set automated reply (optional).](#automated-replies)\
6.5. [Set the team channel to get rotation updates.](#team-channel)\
6.6. [Check the box to receive update notifications.](#team-channel-notifications-and-channel-topic)\
6.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)

7\. 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 on-call, fetch on-call schedule, etc. For example:

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

{% hint style="warning" %}
Keep the following in mind when selecting a team name :

Single word only: Use a single word for 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 on-call 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 on-call(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 usergroup. 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="/files/kADGibMXzH9QvuSag5UF" 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 on-call(s) to be automatically added to the usergroup, you can use this property.\
  **Pagerly would automatically fetch the latest on-call(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="/files/5YWja7ERO6SdDxZQ5Lj3" alt=""><figcaption></figcaption></figure>

### Automated Replies

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

<figure><img src="/files/4SDE3mg9mW4jrQ0n19pX" alt=""><figcaption></figcaption></figure>

***

### Team Channel, Notifications and Channel Topic

#### Team Channel

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

* **Channel Topic Update** : Your slack channel topic would be automatically updated with the current on-call. \\
* **Channel Message** : Your channel would receive a notification on the on-call change

It would look something like this 👇🏻

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

<figure><img src="/files/OaeuPo0PPARSDb43SivH" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/5j9JuECHv0kt4PYBf1Iy" alt=""><figcaption></figcaption></figure>

#### Notification && Topic Settings

Choose whether to receive notifications on on-call/rotation changes and topic updates.

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

<figure><img src="/files/ISVcTfzEiG124RdHV6YZ" alt=""><figcaption></figcaption></figure>

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

<br>
