# 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](/rotations-on-slack/import-holidays-calendar.md) 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.

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

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)


---

# 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/rotations-on-slack/swap-rotation-between-users.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.