# 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.](https://docs.pagerly.io/how-to-work-with-pagerly/create-rotations-using-ai)
{% 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.](https://docs.pagerly.io/how-to-work-with-pagerly/create-round-robin-rotations/how-to-add-multi-user-rotation-in-pagerly)
{% 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="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 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="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 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="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

#### 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="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 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="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

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pagerly.io/how-to-work-with-pagerly/create-round-robin-rotations/how-to-add-rotation-in-pagerly.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
