Incident Labels

This article describes how to use incident labels on incidents. Labels are another way of tracking custom data as well as organizing Incidents. Incident labels are separate and different from Service Catalog labels.

Creating or adding labels to incidents

Labels can be added to incidents both during declaration as well as mid- and post-incident. If a label doesn't already exist, it will automatically be created when adding to the incident.

Note: We do not currently support adding or updating labels anywhere in Slack, regardless of incident phase.

On Declaration

Currently, we support adding labels while declaring an incident in the web UI.

Labels in incident declaration, web UI


We also support adding or updating labels mid-incident via the web UI.

Labels in incident declaration, web UI


Finally, our Retrospective page for each incident also allows you to configure and update the labels.

Labels in incident declaration, web UI

Using labels to filter incidents

On your Incidents page, you can filter the list of incidents by both the Label Key and Value. It is nested in the Filter table just below Tags and above Start date.

If you supply no Value, then the filter will show all incidents that have the specified Label Key.

Labels for filtering incidents

This filtering capability also exists via the GET /incidents API endpoint, and all incidents returned will also contain Labels in the body.

Last updated on 2/9/2024