---
title: "On-Call Rosters"
---

# On-Call Rosters

> <IUCard title="On-Call Rosters" link="https://inductiveuniversity.com/videos/on-call-rosters/8.3" />
> <p></p>

The On-Call Roster defines user groups to be notified when an alarm occurs. Each group includes a list of users in a specific order. Alarm pipeline notification blocks must choose an on-call roster that identifies the users to notify for that notification block. When notifications are sent out by a pipeline, all users on the roster will be notified, except for any off shift (see [schedules](platform/alarming/alarming-schedules/alarming-schedules.md)). 

On-Call Rosters are statically defined, in that they can't be modified from a pipeline. However a [calculated roster](ignition-modules/alarm-notification/alarm-notification-pipelines/pipeline-blocks/notification-block.md) can be created on demand on a notification block. 

## Create and Manage an On-Call Roster
1. Go to the **Services** section of the Gateway Webpage.
2. Click **Alarming** > **Rosters**.

    ![](2020-04-03_16-19-22.png)
 
3. Click on **Create Alarm Roster**.

    ![](2020-04-03_16-21-42.png)
 
4. On the **Create Alarm Roster** form, enter a **Name**, and **Description** if desired, and click **Create Alarm Roster**.
 
    ![](2020-04-03_16-24-47.png)

5. Now on the Alarm Rosters page, expand the three dots menu for the new roster and select **Manage Users**. 

    ![](2020-04-06_11-25-35.png)

6. The **Manage Users** panel is displayed. Here you can add one or all users from a source list, and put them in any order you wish. You can also remove users from the roster.

    ![](2020-04-03_16-31-28.png)

7. Click **Save Changes**.

## Manage the Roster from the Client
Roster management also can take place from within a Vision Client. 

1. Open your project in the **Designer** and navigate to a window the client has access to. If this is a new window, you will have to add it to your navigation.
2. From the Component Palette, drag and drop a **Roster Management** component in your design window.

    ![](2020-08-17_14-47-06.png)

3. If you have more than one user source, go to the Property Editor and enter the one you want to be used by the roster in the **User Source** property.
4. **Save** your project.
5. To interact with the roster, either launch your Vision Client or put your Designer into Preview mode.
6. To edit the roster, double-click any where on the roster or click the **Edit** ![](<edit small-24.png>) icon in the upper right.

    ![](2020-08-17_14-59-11.png)

7. On the Edit Roster screen, you can add an available user to the On-Call Roster, by selecting the user and clicking the **Add User** ![](2020-08-17_15-03-32.png) icon. Alternatively you can add all users by clicking the **Add All Users** ![](2020-08-17_15-03-58.png) icon.

    ![](2020-08-17_15-05-38.png)

8. To delete a user from the roster, select the user and click the **Delete** ![](2020-08-17_17-07-31.png) icon.

For additional information, see the [Vision - Roster Management](appendix/components/vision-components/admin/roster-management/roster-management.md) component.