# Swap Rotation between users

The **Swap Rotation** feature lets you exchange on-call shifts between two users without breaking the overall rotation structure. This is useful when team members need to trade shifts due to availability changes, time off, or last-minute conflicts.

{% hint style="info" %}
For handling a vacation or holiday calendar, follow [next section](https://docs.pagerly.io/rotations-on-slack/import-holidays-calendar) which handles swap automatically
{% endhint %}

When you swap a rotation:

* Both users’ schedules are updated instantly
* The swap applies only to the selected rotation window
* Future rotations remain unchanged
* All connected systems (Slack usergroups, Slack channel updates, calendars, etc.) stay in sync automatically

### What Happens After the Swap

* ✅ Slack usergroups are updated in real time
* 📢 Rotation change notifications are posted to configured Slack channels
* 📝 Slack channel topics are refreshed (if enabled)
* 📅 Synced calendars (Google Calendar, Linear, Jira) reflect the change immediately

### When to Use Swap Rotation

* Team members mutually agree to trade on-call shifts
* Planned unavailability without creating overrides
* Fair redistribution of on-call load within a team

> **Note:** Swap Rotation is ideal for permanent schedule exchanges. For temporary coverage, consider using **Overrides** instead.

### How Swap Rotation Works

{% hint style="info" %}
You can do this directly in slack too , with /schedule \<teamname> command in any slack channel
{% endhint %}

* **Target Rotation**: The specific shift belonging to the first user that you want to replace.
* **Destination Rotation**: The shift from another user that will be swapped with the target rotation.
* Pagerly exchanges ownership of these two rotations while preserving start/end times and rotation rules.

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

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-11-12/d8f6d9cc-b775-4536-87e6-d7f366eb2f00/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=158,435)

2\. Click "Swap Rotation"

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-11-12/ca1c0e05-57a4-4ed0-9881-225c3eb5dd49/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=974,184)

3\. 1. Select the user whose rotation you want to swap.

&#x20;  2\. Select that user's rotation that you want to swap ( Target Rotation ).&#x20;

&#x20;  3\. Select a rotation from another user's schedule that you want to swap the target rotation with .

4\. Click "Swap Schedule".

![](https://ajeuwbhvhr.cloudimg.io/https://colony-recorder.s3.amazonaws.com/files/2025-11-12/574dde61-b9b3-4709-8a6c-b78709b88ad1/ascreenshot.jpeg?tl_px=749,404\&br_px=2278,1258\&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=595,470)