Mobile Incident Management

xMatters Incident Management lets you review, work, and initiate incidents from a simple, intuitive command center. Whatever your role in the incident response process, you can use the Incident Console to track the progress of an incident, collaborate with resolvers, and make relevant updates. With the xMatters mobile app, you can also manage incidents when you're on the go!

Manage incidents from the xMatters mobile app

View incidents

From the app menu, tap Incidents.

The Incidents screen displays a list of the incidents in your system that you have permission to view.



You can view the following information for each incident:

Information Description
Incident ID The incident's identifier in xMatters or an external system.
Date and time When the incident was initiated in xMatters.
Summary & Description

Contextual information about the issue impacting the service or system.

Owner (Incident Commander) The first name, last name, and username of the person currently in charge of the incident.

The impact on the service or system and the level of response that's required:

Minimal: Little or no impact to systems or services; no effect on customer or user access. Situation may require further monitoring.
Low: Minor impact to a non-essential system or service; customers and users unlikely to experience any effects. Situation requires further monitoring.
Medium:  Moderate impact to one or more non-essential systems or services; customers and users may experience some difficulty accessing or performing operations. Unlikely to affect service-level agreements or revenue.
High: Significant impact to important systems or services; customers and users cannot access or perform some essential operations. Service-level agreements may be in jeopardy, and revenue loss is possible.
Critical: Important systems or services are wholly unavailable; customers and users cannot access or perform most essential operations. Service-level agreements are in jeopardy, and significant revenue loss is possible.

The state of the incident resolution process:

Open: Incident triage and analysis underway. The default status of an incident when it’s created. Initial responders are notified and can begin to triage and analyze the incident.
In Progress: Engaged resolvers are actively working on incident resolution.
Mitigated: Users or services are no longer being impacted, but resolvers are still actively engaged in monitoring and incident resolution.
Resolved: Services have been restored, and the incident no longer requires active resolvers. No further notifications will be sent and responses will not be processed.
Rejected: Reject incidents to reduce noise, eliminate duplicates, or exclude incident floods from analytics.

If there are no incidents to display, you either don't have permission to view any of the incidents currently in your system, or the filters you've applied to the list didn't return any results:

^ Back to top


Filter the Incidents list

You can filter the Incidents list to quickly find incidents based on their status or severity, or where you're the incident commander.

The top of the Incidents list indicates which filters you've applied:

To apply filters or edit their values, tap the filter icon at the top of the screen:

Filter by status and severity

To filter by status or severity, select the status and severity values of the incidents you want to see. You can select multiple values for each filter.

To update the Incidents list, tap Apply Filters on iOS, or the back arrow on Android.

This example will display Open or In Progress incidents that are Critical or High severity:

Filter by incident commander

To filter for the incidents you're the incident commander of, tap the Me (username) filter.

To update the Incidents list, tap Apply Filters on iOS, or the back arrow on Android.

Clear filter values

To remove filters from the Incidents list, do one or more of the following:

  • To clear all filter values, tap Reset at the top of the Filters screen.
  • Tap any selected values for the Status or Severity filters to deselect them.
  • To view incidents with any incident commander, tap All.

To update the Incidents list, tap Apply Filters on iOS, or the back arrow on Android.

^ Back to top


Initiate an incident

When you initiate an incident in xMatters, you provide details about the incident and identify who you want to engage to resolve it. This starts an incident resolution workflow in xMatters which notifies resolvers to engage and builds out the Incident Console with the details you provided.

To initiate an incident:
  1. On the Incidents screen, tap Initiate.
    • xMatters displays the incident resolution workflows you have access to, including an option to Initiate an Incident using the generic xMatters 'Incident Management Workflow'.
  2. From the list of available options, tap the incident submission form you want to submit.
    • Forms must be enabled for the mobile app for them to appear in the list of options.
  3. On the Initiate Incident screen, provide details about the incident, including a high-level Summary, a concise Description, and an estimate of its current Severity.
    • This information is included in the message sent to the targeted resolvers and is used to populate the incidents details in xMatters.
  4. In the Resolvers section, add the people or groups you'd like to target to engage in resolving the incident.
    1. If you target a group, only the first on-call resource that responds is added to the incident as a resolver.
  5. Tap Submit.

You're automatically redirected to the Incident Console once your incident is initiated in xMatters. Alternatively, you can tap View Incidents to return to the Incidents screen while the incident is initiated. Once it appears in the Incidents list, tap the incident to open the Incident Console.

^ Back to top


View and update incident details

On the Incidents list, tap an incident to open the Incident Console.

The Incident Console is your heads-up display for working an incident. You can find and update incident details, gather your resolution team, and connect to chats or conference bridges associated with the incident.


The incident summary appears as the title of the incident. The summary is usually short and includes key information to help categorize the incident. As the incident progresses, you can update the summary to clarify details about the incident or provide further contextual information as it becomes available.

To update the summary of an incident:

iOS: Tap the field to edit its value, then tap done.

Android: Tap the pencil icon to edit the incident summary and then click Save.

^ Back to top


The incident status indicates the state of the incident resolution process. Incidents default to an 'Open' status when they are initiated in xMatters. When someone starts working the incident, they can set its status to 'In Progress' to indicate they're engaged in resolving the issue. They can then move the incident through the remaining resolution states as the incident's lifecycle progresses.

To update the status of an incident:

iOS: Tap the Status field and select a new value, then tap Done.
Android: Tap the Status field and select a new value.

^ Back to top


The severity of an incident indicates the impact on the service or system and the level of response that's required. Your organization may establish different criteria to classify the severity of an incident and how this field is updated as an incident progresses.

To update the severity of an incident:

iOS: Tap the Severity field and select a new value, then tap Done.
Android: Tap the Severity field and select a new value.

^ Back to top

Impact Duration

Impact duration is the length of time the incident impacted the business. By default, the impact duration starts when the incident is initiated in xMatters and ends when the incident is moved to the 'Mitigated' status (or the 'Resolved' status, if you bypass 'Mitigated').

You can't currently update the incident's impact duration from the mobile app.

^ Back to top

Created / Initiated At

iOS: The Created field displays the date and time the incident was initiated in xMatters.

Android: The date and time the incident was initiated at, and who it was initiated by, is displayed under the incident summary.

^ Back to top


The incident description provides contextual information about the issue impacting the system or service. The initial value for this field is provided by the person or workflow that initiates the incident in xMatters. This information helps you triage the incident, understand which services or systems are affected, and identify who you need to engage to resolve the issue.

To edit the incident description:
  1. Tap an incident description to edit its value.
    • The description can be up to 2000 characters long.
  2. To save your changes:
    • iOS: Tap Done.
    • Android: Tap Save.

^ Back to top

Manage resolvers

The Resolvers tab of an incident displays who's engaged in the incident and their role in the resolution process. As an incident progresses, you can add additional resolvers, renotify users or teams that haven't responded, and dismiss resolvers when you no longer need them.

By default, the person who initiates an incident is assigned the Incident Commander role. If you need to hand off responsibility of the incident, you can reassign another engaged resolver as the Incident Commander. You can't currently assign or edit other incident roles from the mobile app.

Add resolvers

You can add resolvers to an incident by sending them a notification requesting they engage, or by adding them directly to the Resolvers list without sending them a notification. Adding resolvers directly is useful when someone is already working an incident and you want to add them to the Resolvers list without making them stop to acknowledge a message.

If the incident has impacted services, you can also notify a service to engage as a resolver and a notification will be sent to the group that owns the service.

When you notify a resolver to engage, the Resolvers list displays their name and the status of the notification process: whether xMatters is 'Notifying' them or if there was 'No Response'. Resolvers who accept the request to engage (or those that were directly added as engaged) are marked as 'Engaged' in the incident.

To add additional resolvers:
  1. On the Resolvers tab of an incident, tap Add Resolver on iOS, or + Resolver on Android.
  2. Select one of the following options:
    • Notify to Engage: Send a notification to users, groups, or dynamic teams, requesting they engage.
    • Add as Engaged: Skip the notification process and display the resolver as engaged in the incident.

  1. Select the resolvers you want to add.
  2. Tap Done on iOS, or the back arrow on Android.

^ Back to top

To add impacted service owners as resolvers:

Do one of the following: 

^ Back to top

Renotify resolvers to engage

If a resolver hasn't responded to a notification, or you previously stopped notifications to them (in the web user interface), you can notify them again.

To renotify a resolver to engage:

Tap the options menu (the ellipses icon) for the resolver you want to renotify, and then tap Notify to Engage.

^ Back to top

Dismiss resolvers

You can dismiss resolvers from an incident. This is helpful for indicating which resolvers are no longer needed to actively engage in resolving the incident, and for keeping an accurate record of when and how long each resolver was engaged.

To dismiss a resolver:

Tap the options menu (the ellipses icon) for the resolver you want to dismiss, and then tap Dismiss Resolver.

When you dismiss a resolver from an incident, they're listed in a Dismissed section at the bottom of the Resolvers list, and an entry is added to the timeline for their dismissal.

^ Back to top

Reassign the Incident Commander role

The Incident Commander is the resolver in charge of the incident. It's their responsibility to guide the incident to resolution, oversee resolution activities, and make the final call on decisions related to the incident. By default, the user that initiates the incident is assigned as the Incident Commander. If you need to hand off responsibility of the incident during the resolution process, you can replace the current commander with any engaged resolver.

To reassign the Incident Commander role:
  1. Tap the options menu (the ellipses icon) for an engaged resolver, and then tap Assign as Commander.

  1. In the confirmation dialog box, tap Confirm on iOS, or OK on Android.

When you reassign the Incident Commander, the replaced resolver is added or returned to the list of resolvers. If the resolver was engaged as part of a group before they became the Incident Commander, they'll be listed under that group when they're returned to the list.

^ Back to top

Collaborate across teams

The Collaboration field or section appears for an incident when there are chats, meeting rooms, or conference bridges associated with the incident. You can join a collaboration channel or share its details with someone else.

On iOS, the collaboration field indicates how many collaboration channels are associated with the incident:

Tap Collaboration to view details about the collaboration channels:

On Android, the Collaboration section appears on the Overview tab of the incident:

To join a chat channel:

iOS: Tap the name of the channel.
Android: Tap Join below the channel name.

To open the channel in the chat app, you need to have the associated app installed on your mobile device.

To join an xMatters conference bridge:

Tap the conference bridge on iOS, or Join on Android, to display options for dialing either the toll or toll-free number:

To share collaboration details:

Tap the share icon on iOS, or Share on Android, to share details of a collaboration channel with someone else using your device's sharing capabilities:

^ Back to top

Identify impacted services

The Overview tab of an incident includes an Impacted Services section where you can identify which services are reported as affected by the incident.

The service's appearance conveys information about the service:

Appearance What does this mean?
Bold Outline Owner was notified to engage
Regular outline Owner has not been notified to engage
Dashed outline Undefined service does not exist in the Service Catalog
Grayed-out & struck-through Deleted service

Tap on a service to view more details about it, including its name, description, whether it's reported in any other active incidents, or to notify the group that owns the service to engage.

^ Back to top

Notify impacted service owners to engage

You can easily notify the group that owns a service to engage as an incident resolver by tapping Notify to Engage when viewing a service's details.

Once you've sent the request, tap See Resolver to view the service and its in the Resolvers list.

^ Back to top

View and add notes to the timeline

The incident Timeline lets you keep track of everything that happened during the incident, by automatically recording incident activity in real-time and noting who made the change. Any resolver can manually add notes to the timeline with additional information about how the incident is progressing.

To view the timeline for an incident:

Tap the Timeline tab.

To sort the timeline:

Tap the sort option to arrange the timeline entries chronologically.

  • iOS: 'Newest to Oldest' or 'Oldest to Newest'
  • Android: 'Newest First' or 'Oldest First'

To search the timeline:

You can narrow the timeline entries by searching for a keyword in the name of a user or group, or the content of a note.

To filter the timeline by the type of entry:

Tap the filter drop-down menu to select the type of timeline entries you want to display.

To add a note to the timeline:
  1. On the Timeline tab, tap Add Note on iOS, or + Add Note on Android.

  1. In the Add a Note field, enter up to 1000 characters, then tap Save.

^ Back to top