Manage subscriptions

In the side navigation menu, click Subscriptions.

To quickly sort the subscriptions in your list, do one or more of the following:

• To sort the content of a column alphabetically, click the column header. (Click the header again to reverse the sort order.)
• To change the width of a column, move the pointer over the edge of the column in the header and, when the re-size icon appears, click and drag the column to the desired size.
• To rearrange the columns, click and drag a column header to a new location in the table.
• If the list contains more entries or columns than can be displayed on your screen, scroll horizontally or vertically. The system automatically loads more data as you scroll down the page.

The Subscriptions list includes the following columns:

• Subscription: The subscription's name and description.
• Owner: The user who owns the subscription.
• Subscribers: The number of users subscribed to the alert.
• Criteria: The alert information criteria that trigger a notification.
• Subscription Form: The subscription form in the workflow where the alert is triggered.
• Date Created: The date the subscription was created.

You can use the search bar to find subscriptions that contain the search term in their name.

Start typing in the search bar (a minimum of two characters is required). The page automatically updates the list to display items that contain (partially match) the search term, and highlights the portion of each item that matches the specified criteria. If you search multiple terms, xMatters returns subscriptions that match all of the terms.

To clear your search, click the 'x' in the right corner of the search bar.

The available filters allow you to narrow the subscriptions list based on matching specific criteria. For example, you can use filters to find subscriptions owned or subscribed by specific users.

You can apply one or more filters to narrow down the list of subscriptions. If you apply multiple filters, xMatters only returns subscriptions that match all of the specified filter criteria. For detailed instructions on how to use filters, see Filtering data tables.

The following table describes the available filters in the subscriptions list and their values:

To add a new subscription:

1. Click Add Subscription at the top-right corner of the page, and then select the name of the subscription form that you want to subscribe to.
2. On the Add Subscription page, enter the following information:
   • Name: Provide a name for the subscription.
   • Description: Type a meaningful description that will help you later identify the purpose of this subscription.
   • Criteria: xMatters sends you notifications only for alerts that match the specified criteria. For more information about setting the criteria for subscriptions, see Subscription criteria.
   • Subscribers: Add the users, groups, and services that you want to be notified when the subscription alert is triggered. The 'Subscribe Others' setting on the associated subscription form must be enabled for this section to be displayed.
   • Delivery Methods: Select the check box next to the types of devices that should receive notifications for this subscription. The 'Devices' section on the associated subscription form must be visible for the device options to be available.
   • Notification Delay: The number of minutes for xMatters to wait before sending you a notification. If the alert is terminated before this time elapses, then xMatters does not send a notification. This enables you to be notified only when alerts remain unresolved for a certain length of time. Set this value to 0 to be notified as soon as the alert occurs.
3. If the Subscribers section is unavailable, you can add yourself as a subscriber by selecting the check box at the bottom of the page.
4. Click Save.

To view an existing subscription's details, click the name of the subscription you want to view in the Subscriptions list to open its details page. If you have permission to modify the subscription, click Manage on the top-right corner of the page then update the fields as needed.

To add or remove subscribers from the subscription's details page:

1. Click the name of the subscription you want to view from the Subscriptions list.
2. On the Subscribers section of the subscription's details page, click Manage Subscribers. The 'Subscribe Others' setting on the associated subscription form must be enabled for this button to be displayed.
3. In the Manage Subscribers dialog, do one of the following:
   • To add a subscriber, select All or the type of subscriber (Users, Groups, or Services) you want to search for and type their name to search the list. Select the check box beside their name in the Available area to move them to Selected area.
   • To remove a subscriber, click the 'x' beside their name in the Selected area to move them to Available area, or click Remove all to remove all subscribers.
4. Once you're happy with your changes, click Apply.

To delete one or more subscriptions:

1. Select the check box next to the subscriptions that you want to delete.
2. Click Delete.
3. Once you review the confirmation message, click Delete Subscriptions.

To share a subscription and configure permissions:

1. Click your username, and then select Subscriptions.
   • To share a subscription from the Subscriptions list, click the name of the subscription you want to view from the list, then click Permissions on the top-right corner of its details page.
2. Click the link in the Shared column for the subscription you want to share.
3. On the Share Subscription dialog, type the name of a user or role in the search field to add them to the list.
4. By default, users and roles are assigned the 'Subscribe and Unsubscribe' permission. To modify the permissions, click the link in the Permissions column, and then select one or more of the following check boxes in the drop-down list:
   1. Subscribe and Unsubscribe: Allows the user to choose to subscribe to this alert feed, or unsubscribe if they do not want to receive notifications.
   2. Subscribe Others: Allows the user to subscribe and unsubscribe other users and roles. This permission is only available when the 'Subscribe Others' setting on the associated subscription form is enabled.
   3. View Subscription: Allows the user to view the subscription details, but does not allow them to modify the subscription.
   4. Edit Subscription: Allows the user to view and edit the subscription settings and criteria. Any changes to the subscription details will affect all users subscribed to this alert feed.
5. To remove a user or role from the list, click the red X on the right side of their row.
   1. Removing a user or role from the shared list does not remove any existing subscriptions; if they are currently subscribed, they will continue to receive notifications based on their subscription.
6. Click Save Changes.

To change the owner of one or more subscriptions:

1. Click your username, and then select Subscriptions. You can also change owners from the Subscriptions list.
2. Select the check box next to the subscriptions that you want to change ownership.
   1. If you do not see a check box next to a subscription, you do not have permission to change the subscription owner.
3. Click Change Owner.
4. In the Change Subscription Owner dialog, select the new owner, and click OK (user profile tab) or Change Owner (Subscriptions list).
   • If the new owner already has a subscription with the same name, the name of the new owner is appended to the end of the existing subscription name.