> ## 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.

# Announcements

> Control what your incident announcement posts look like with templates, and where they get posted with rules

Announcements keep everyone informed by sharing incidents in a Slack or Microsoft Teams channel.

You don't need to set anything up to get started. Every account comes with a default template and a default rule, so incidents are announced automatically from day one. This page is about customizing that behaviour, which comes in two parts:

* **Templates** control what your announcement posts look like: the fields, actions, and emojis that appear in the post.
* **Rules** control which incidents get announced, and where.

To customize either, go to [Settings → Announcements](https://app.incident.io/~/settings/announcements).

<Frame caption="The Announcements settings page, with your Templates and Rules">
  <img
    src="https://mintcdn.com/incidentio-18bb4170/L9ToxNtmN_TtGxo_/images/announcements/settings-overview.png?fit=max&auto=format&n=L9ToxNtmN_TtGxo_&q=85&s=93aa94a3dc5f901754258d0122564b18"
    alt="The Announcements settings page, showing the Templates and Rules
sections"
    width="2382"
    height="1174"
    data-path="images/announcements/settings-overview.png"
  />
</Frame>

## Templates

A template controls what an announcement post looks like. Every account starts with a single template, which is marked as your **Default**. This is the template used whenever a rule (or workflow) doesn't specify one.

Click a template to edit it. You can add or remove fields and actions, reorder them, and configure which emojis appear next to each field, with a live preview of the post as you go.

<Frame caption="Editing an announcement template, with a live preview of the post">
  <img
    src="https://mintcdn.com/incidentio-18bb4170/L9ToxNtmN_TtGxo_/images/announcements/edit-template.png?fit=max&auto=format&n=L9ToxNtmN_TtGxo_&q=85&s=cba33bc82b2f8d203e13fbb2eddf43cc"
    alt="The Edit announcement template drawer, showing the fields and actions and a live preview of the
post"
    width="2036"
    height="2374"
    data-path="images/announcements/edit-template.png"
  />
</Frame>

To add a field or action, click **Add** and pick from the list.

<Frame caption="Adding a field to a template">
  <img src="https://mintcdn.com/incidentio-18bb4170/L9ToxNtmN_TtGxo_/images/announcements/add-field.png?fit=max&auto=format&n=L9ToxNtmN_TtGxo_&q=85&s=0657e5bdd47abb8cc6b48ea1c700718d" alt="Adding a field to a template by picking from the Add menu" width="2036" height="2380" data-path="images/announcements/add-field.png" />
</Frame>

### Using more than one template

You're not limited to a single template. Click **Add template** to create additional templates. This is useful when you want variations for specific purposes, such as a stripped-back post for a particular audience, or a template paired with a specific [announcement rule](#rules) so different incidents are announced differently.

<Info>
  You can also choose a template in the **Post an incident announcement** step of a [workflow](/workflows). Leaving it
  blank falls back to your default template.
</Info>

## Rules

Rules control which incidents get announced, and where. By default, we announce every new incident and its updates in a single channel. In Slack, that's your `#incidents` channel.

Click a rule to edit it. You can change which channel it posts to, add conditions so it only fires for specific incidents (for example, announcing critical incidents in `#customer-support` too), and pick which template it uses.

<Frame caption="Editing an announcement rule, with a live preview of the post">
  <img
    src="https://mintcdn.com/incidentio-18bb4170/L9ToxNtmN_TtGxo_/images/announcements/edit-rule.png?fit=max&auto=format&n=L9ToxNtmN_TtGxo_&q=85&s=71aeaeffab009e0e06477b96af3c6071"
    alt="The Edit announcement rule drawer, showing the rule's settings, conditions, and a live preview of the
post"
    width="2544"
    height="2648"
    data-path="images/announcements/edit-rule.png"
  />
</Frame>

Click **Add rule** to create a new rule, for instance to call out specific incident types or severities in a separate channel.

<Note>
  Don't delete whichever channel you're using for default announcements. On Slack, if you already had an `#incidents`
  channel when you installed our app, we'll have created a channel called `#incident-io-incidents` instead, which you
  can rename to whatever you'd like.
</Note>

For more on redirecting announcements to a different channel, see [Announcement channels](/incidents/change-announcements).

## Team ownership

You can give one or more teams ownership of a template or a rule:

* **Templates**: set the **Template owner** field when you create or edit a template. Your default template can't be team-owned, and choosing which template is the organization default stays an account-level action.
* **Rules**: set the **Announcement rule owner** field in the rule's create or edit drawer.

Ownership assigns the template or rule to a team. If your organization uses [team roles](/admin/team-roles), that ownership also controls who can manage it: only members of an owning team with the **Manage announcements** permission, or anyone who holds it account-wide, can make changes, and reassigning ownership always needs that permission granted account-wide. See [Team resources](/catalog/team-resources) for what ownership means more generally.

Each team can see the templates and rules they own on their own **Settings → Announcements** page.

<Frame caption="A team's owned announcement templates and rules, on their team settings page">
  <img
    src="https://mintcdn.com/incidentio-18bb4170/1bOtFU7v3wez4HQd/images/announcements/team-owned-announcements.png?fit=max&auto=format&n=1bOtFU7v3wez4HQd&q=85&s=85945d0e7c850ded50d986aeccec0bfc"
    alt="The Announcements tab of a team's settings, listing the template and rule owned by that
team"
    width="2476"
    height="1160"
    data-path="images/announcements/team-owned-announcements.png"
  />
</Frame>

## FAQs

<AccordionGroup>
  <Accordion title="What's different on Microsoft Teams?">
    Not much. Templates and rules are configured in the same place and work the same way on both platforms.

    The main difference is the default announcement channel: on Slack it's your `#incidents` channel, whereas on Microsoft Teams it's the General channel of your Incidents team. See [Announcement channels](/incidents/change-announcements) for more.
  </Accordion>

  <Accordion title="Can I @mention a Slack user group in an announcement post?">
    The announcement builder does not currently support free-form text or @mentioning Slack user groups directly in the announcement post.

    If you need to notify a specific team when an incident is announced, consider these alternatives:

    * **Announce to the team's Slack channel**: Use a [rule](#rules) to post directly to the relevant team's channel.
    * **Invite the user group via a workflow**: Set up a [workflow](/workflows) to automatically invite the Slack user group to the incident channel.
    * **Auto-subscribe to certain incidents**: Encourage folks to [auto-subscribe](/incidents/subscribing) to incidents belonging to their team.
  </Accordion>
</AccordionGroup>
