> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incident.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Grouping alerts

> Group related alerts into an alert group so you can triage, escalate and attach them to incidents as one.

Alert sources can fire many alerts for the same underlying issue. **Alert grouping** groups those related alerts into a single **alert group**, so you can triage, escalate and attach them to an incident once — instead of handling each alert on its own.

<Note>
  We're currently migrating organisations onto our new alert grouping. While your organisation is being migrated, you may not yet be able to configure grouping outside of incidents. Once you're fully migrated, you'll have access to everything described below.
</Note>

## How it works

When grouping is enabled on an alert route, each incoming alert is matched to a group using the attributes you've chosen to group by, such as service or region. Alerts that share a key join the same group, as long as they arrive within the group's time window. Windows can be configured in two ways:

* **Fixed window** — the group stays open for a set time after it's created.
* **Extending window** — the window resets each time a new alert joins, so the group stays open while related alerts keep arriving.

An alert group is a bucket of alerts and it takes its **title and description from the first alert** to join.

<Frame>
  <img
    src="https://mintcdn.com/incidentio-18bb4170/xT2bRQ6dP6OWfLJW/images/help-centre/grouping-alerts/alert-group-detail.png?fit=max&auto=format&n=xT2bRQ6dP6OWfLJW&q=85&s=f5ba44382346396d57507b5f7a3a50f7"
    alt="An alert group for a PodCrashLooping alert, showing five grouped alerts in the left pane and, on the right, the
group's related incidents, related escalations, and a timeline recording that the group was created by grouping on
Alert Title within an extending 30-minute window"
    width="1234"
    height="1060"
    data-path="images/help-centre/grouping-alerts/alert-group-detail.png"
  />
</Frame>

## Setting up grouping

Grouping can be configured per alert route:

1. Open the alert route you want to group alerts on.
2. Enable grouping and choose the **attributes** to group by.
3. Choose a **fixed** or **extending** window.

<Frame>
  <img
    src="https://mintcdn.com/incidentio-18bb4170/xT2bRQ6dP6OWfLJW/images/help-centre/grouping-alerts/group-alerts-config.png?fit=max&auto=format&n=xT2bRQ6dP6OWfLJW&q=85&s=85226325f6fdbfdb3cd3f8329e8c93db"
    alt="The Group alerts configuration on an alert route, with grouping turned on, a 30-minute window set to Extending, and
alerts grouped by Alert Title"
    width="1296"
    height="1016"
    data-path="images/help-centre/grouping-alerts/group-alerts-config.png"
  />
</Frame>

You can then choose to create an incident from grouped alerts, and whether alerts should also create escalations. When they do, you control how a group pages as new alerts join:

* **On every new alert** — page each time an alert joins the group.
* **On priority increase** — only page when an alert with a higher priority joins the group.
* **After a grace period** — wait a set number of minutes before paging, giving you time to action the alert first.

<Frame>
  <img
    src="https://mintcdn.com/incidentio-18bb4170/xT2bRQ6dP6OWfLJW/images/help-centre/grouping-alerts/escalation-options.png?fit=max&auto=format&n=xT2bRQ6dP6OWfLJW&q=85&s=cb5634e9b0cc0f6f01129d2bb77ed8f7"
    alt="The escalation options for an alert group, with choices for On every new alert, On priority increase, and After a
grace period, and a grace period set to 5 minutes"
    width="1218"
    height="527"
    data-path="images/help-centre/grouping-alerts/escalation-options.png"
  />
</Frame>

## Attaching groups to incidents

If incident creation is enabled on the route, alert groups are attached to incidents automatically. You can also attach a group to a new or existing incident yourself.

## Managing alerts in a group

From Slack, Teams or the dashboard, you can take an alert out of its group and:

* **Reprocess it** — send it back through the alert route as if it were new (it won't rejoin the group).
* **Create a new incident** from it.
* **Attach it to an existing incident**.
* **Leave it ungrouped** — remove it from the group and do nothing else.

## FAQs

<AccordionGroup>
  <Accordion title="Can I rename an alert group?">
    Not yet — a group's title and description come from the first alert to join it, and aren't editable.
  </Accordion>

  <Accordion title="Can I close a group manually?">
    No. Groups close automatically when their window expires, or when all attached incidents are resolved. You can
    resolve a group's alerts, but there's no manual close.
  </Accordion>

  <Accordion title="Can I unlink the group that created an incident?">
    You can detach other groups attached to an incident, but not the group that originally opened it.
  </Accordion>

  <Accordion title="Are alert messages grouped too?">
    As part of the alert routing configuration, you can choose a Slack or Teams channel to post messages when alerts go
    through the route. These messages don't currently contain information about the alert group.
  </Accordion>
</AccordionGroup>
