Skip to content

Create a rotation

A rotation is the core element of Round Robin: a pool of people (added directly or through Slack user groups) who take turns being on duty. This tutorial walks you through creating your first rotation from the web dashboard — the primary way to manage Round Robin — with Slack as a quick alternative.

  1. Sign in at app.roundrobinbot.eu and open Rotations. This page lists all rotations you can see, with search and filters.

    The All Rotations page in the dashboard, with search, filters, and rotation cards

  2. Click Create Rotation.

  3. Work through the three tabs — Details (name, code, description, public/private), People & Groups (owners, members, member user groups), and Channels. Everything is saved together.

    The Create Rotation page with the Details tab filled in, showing Name, Code, Description, and the Public toggle

  4. Click Create Rotation. You land on the new rotation’s page, where you can continue with schedules, templates, and integrations.

A few dashboard-specific details:

  • The Code field accepts only letters, numbers, and hyphens, and is stored uppercase.
  • You are pre-filled as an owner and cannot remove yourself.
  • You can leave members, groups, and channels empty and configure them later from the rotation page or from Slack.
Field Required Plan What it does
Name Yes All Identifies the rotation everywhere.
Description No All Helps members understand what the rotation is for.
Code No All A short, memorable identifier (no spaces) other users can use to notify whoever is on duty by mentioning the bot, e.g. @Round Robin ENG-ONCALL. See Mentions.
Duty size No Pro How many members are on duty at the same time (default 1).
Owners Yes Pro Owners manage the rotation and are the only ones who can edit it. Being an owner does not make you a member. You must always be in the owners list yourself — the form is rejected otherwise, so you cannot lock yourself out. On the free plan the field is hidden and you become the owner automatically.
Visibility No Pro Mark the rotation as private to make it visible only to owners and members. By default a rotation is public. Free-plan rotations are always public.
Channels No All Channels notified on rotation events, such as a change of duty. The bot cannot post to private channels it is not a member of.
Members No All Users in the on-call pool who take duty turns.
Groups No All Slack user groups whose members join the pool. If the group’s membership changes later, the rotation updates automatically.

Open the rotation from the Rotations list and edit it. The same tabs appear pre-populated with the current values: use People & Groups to manage owners, members, member user groups, and duty size, and Channels to change which channels are notified.

The edit rotation People & Groups tab, showing members, owners, groups, and duty size

The edit rotation Channels tab

You can also create and edit rotations without leaving Slack. The central Round Robin command is /rr — usable in a direct message with the bot or in any channel.

  1. Type /rr in any conversation. The bot replies with your rotations list. The first time, it looks like this:

    The bot response to /rr, with a Create button

  2. Click Create. The New rotation modal opens with the same fields described in the table above.

  3. Fill in at least a Name, then click Create. The bot confirms with a summary of the new rotation:

    Confirmation view shown after creating a rotation

All bot replies in this flow are visible only to you, not to the whole channel.

You can also open the same modal from the Slack shortcut menu (look for Create a rotation) or from the bot’s App Home tab with the New rotation button.

The Create a rotation Slack shortcut

Editing works the same way: open the rotation from /rr and choose to edit it, and the modal appears pre-populated. After you Save, the bot shows the updated state of the rotation:

Rotation summary shown after saving an edit