---
title: "Configure labels | Grafana Cloud documentation"
description: "How to configure labels for Grafana IRM integrations and alert groups."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# Configure labels

This page explains how to configure labels on Grafana IRM integrations. Labels determine how alert groups are categorized and routed.

To create or manage labels, refer to [Label management](/docs/grafana-cloud/alerting-and-irm/label-management/). This page covers how to configure labels on your integrations using static labels, dynamic labels, and multi-label extraction templates.

Labels are key-value pairs (for example, `team_name: infrastructure`). Default label keys in IRM include `service_name` and `team_name`, but you can define any keys that fit your needs.

To configure labels on an integration:

1. In Grafana IRM, go to the **Integrations** page and select the integration you want to configure.
2. Click the **three-dot menu** next to the integration and select **Integration settings**.
3. In the **Label Schema** section, choose between **Static** and **Dynamic** labels, then click **+ Add label**.
4. Enter a key-value pair for the label by selecting an existing key, adding a new one, or using a Jinja template.
5. Click **+ Add**, then click **Update integration** to save your changes.
6. (Optional) Click the **pencil icon** next to the **Multi-label Extraction Template** to configure multiple labels in a single template.

## Configure static labels

Static labels are tied to the integration they are configured for and applied to all alerts from that integration.

To configure static labels:

1. In the **Static labels** section of the **Label Schema**, click **+ Add label**.
2. Enter a key-value pair (for example, `team_name: infrastructure`).
3. Click **+ Add** to save the label.

## Configure dynamic labels

Dynamic labels assign values to alert groups based on data extracted from the alert payload. These labels use a static key but extract their value dynamically using Jinja templates. These labels are **not** available for label management on [Label management](/docs/grafana-cloud/alerting-and-irm/label-management/).

To configure dynamic labels:

1. In the **Dynamic labels** section of the **Label Schema**, click **+ Add label**.
2. Enter the key for the label (for example, `severity`).
3. Define the extraction logic using a **Jinja template** to extract the label value from the alert payload.
4. Click **+ Add** to save the label.

### Example: Dynamic label extraction

Consider a dynamic label that extracts the severity level from the alert payload:

Template:

jinja2 ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```jinja2
{{ payload.get("severity") }}
```

The following image shows the resulting dynamic label configuration:

![Example of a dynamic label extracting severity level from alert payload](/static/img/oncall/dynamic-label-example.png)

Given the following alert payloads:

Alert 1:

JSON ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```json
{
  "title": "critical alert",
  "severity": "critical"
}
```

Alert 2:

JSON ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```json
{
  "title": "warning alert",
  "severity": "warning"
}
```

Resulting labels:

- The first alert group receives the label: `severity: critical`.
- The second alert group receives the label: `severity: warning`.

## Multi-label extraction template

For advanced use cases, the multi-label extraction template extracts multiple labels from an alert payload using a single Jinja template. This is useful for alerts containing multiple key-value attributes.

To configure a multi-label template:

1. In the **Label Schema** section of your integration settings, open the **Multi-label Extraction Template**.
2. Enter a **Jinja template** that outputs a valid JSON dictionary.
3. Click **Save**, then click **Update integration**.

### Example: Multi-label extraction

Consider an alert with the following payload:

Incoming payload:

JSON ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```json
{
  ...
  "commonLabels": {
    "job": "node",
    "severity": "critical",
    "alertname": "InstanceDown"
  },
  ...
}
```

Template:

jinja2 ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```jinja2
{{ payload.commonLabels | tojson }}
```

Resulting labels applied to the alert group:

- `job: node`
- `severity: critical`
- `alertname: InstanceDown`

![Multi-label extraction result](/static/img/oncall/mutli-label-extraction-result.png)

### Advanced example: Extracting and modifying labels

This example extracts multiple labels, adds a new one, and modifies another.

Template:

jinja2 ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```jinja2
{%- set labels = {} -%}
{# add several labels #}
{%- set labels = dict(labels, **payload.commonLabels) -%}
{# add one label #}
{%- set labels = dict(labels, **{"status": payload.status}) -%}
{# add label not from payload #}
{%- set labels = dict(labels, **{"service": "oncall"}) -%}
{# dump labels dict to json string, so OnCall can parse it #}
{{ labels | tojson }}
```

This template results in the following labels:

- Extracts labels from `commonLabels`.
- Adds a `status` label from the payload.
- Adds a static `service:oncall` label.

## Customize the Alert Group table

You can customize the Alert Group table to display relevant information for each user. Select which columns to show and add custom columns based on labels.

### Manage default columns

By default, the Columns dropdown provides predefined columns that users can enable or disable. Use the **toggle switch** next to each column name to show or hide it in the table.

### Add custom columns

Users with admin permissions can create custom columns based on labels.

To add a custom column:

1. Click **Add** in the Columns dropdown. A modal appears.
2. Enter the name of the label key you want to use as a column.
3. Select the label from the available options.
4. Click **Add**.

The new custom column appears in the Column Settings and is available for all users.