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 The user 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 owner.

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 owner

To filter for the incidents you're the owner 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 owner, 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 the xMatters Incident Management workflow, which notifies resolvers to engage and builds out the Incident Console with the details you provided.

For the initial release of Incident Management to our mobile platform, you're only able to initiate incidents using the default xMatters Incident Management workflow, not custom Incident Resolution workflows.

To initiate an incident:
  1. On the Incidents screen, tap Initiate.
  2. 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.
  3. 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.
  4. 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 incident summary, tap the field to edit its value, then tap Done.

^ 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


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

^ Back to top


The Resolvers field displays the users, groups, and dynamic teams engaged in the incident resolution process. You can add additional resolvers to an incident from the mobile app.

To add new resolvers to the incident:
  1. Tap the Resolvers field.
  2. Select the new resolvers you want to add.
  3. Do one of the following:
    • iOS: Tap Done.
    • Android: Tap the back arrow.

^ 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 Confirm.

^ Back to top


The Collaboration field appears on the Incident when there are chats, meeting rooms, or conference bridges associated with the incident.

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

Tap Collaboration to view more details, join a collaboration channel, or share its details with someone else.

To join a chat channel:

Tap the name of the channel to open it in the chat app. This requires you have the associated app installed on your mobile device.

To join an xMatters conference bridge:

Tap the conference bridge to display options for dialing either the toll or toll-free number:

To share collaboration details:

Tap the share icon to share details of a collaboration channel with someone else using your device's sharing capabilities:

^ Back to top


The Roles section displays who is responsible for the different roles in the incident resolution process:

  • Owner: The user currently in charge of the incident.
  • Reporter: The user who initiated the incident or whose credentials were used to authenticate the workflow that initiated the incident.

You can't currently edit the users assigned to an incident's roles from the mobile app.

^ Back to top