# incident.io

## Learn more about Sentry's incident.io integration and how you can easily attach Sentry issues to ongoing incidents.

The incident.io Sentry integration supports Sentry exceptions as incident attachments and can manage Sentry resources from within [incident.io](https://incident.io/).

This integration is maintained and supported by the company that created it. For more details, check out our [Integration Platform documentation](/organization/integrations/integration-platform/).

## [Install](#install)

Sentry owner, manager, or admin permissions are required to install this integration. incident.io **won't** work with self-hosted Sentry.

The preferred way to install the incident.io integration is by sharing a Sentry link in your active incident Slack channel, which prompts you to add the integration:

[![Prompt to add incident.io integration in Slack.](/_next/image/?url=%2Fmdx-images%2Fincidentio-slack-install-FZUT4GBT.png%231446x276\&w=3840\&q=75)](/mdx-images/incidentio-slack-install-FZUT4GBT.png)

To add the incident.io integration in [sentry.io](https://sentry.io), navigate to **Settings > Integrations > incident.io** and click "Install":

[![incident.io integration installed](/_next/image/?url=%2Fmdx-images%2Fincidentio-install-PS4JRLCP.png%231940x728\&w=3840\&q=75)](/mdx-images/incidentio-install-PS4JRLCP.png)

## [Issue Linking](#issue-linking)

Issue linking allows you to attach Sentry issues to existing incidents. Issue linking can be accomplished in Slack or within [sentry.io](https://sentry.io).

### [In Slack](#in-slack)

To attach a Sentry issue to an incident in Slack, share a link to the Sentry issue and click "Yes, attach it" when prompted:

[![Prompt to attach Sentry issue to incident in Slack](/_next/image/?url=%2Fmdx-images%2Fincidentio-attach-prompt-ESO3QVNJ.png%231352x498\&w=3840\&q=75)](/mdx-images/incidentio-attach-prompt-ESO3QVNJ.png)

The Sentry issue is now attached to the incident:

[![Incident with Sentry issue attached](/_next/image/?url=%2Fmdx-images%2Fincidentio-attach-post-NLGHAMBH.png%231034x352\&w=3840\&q=75)](/mdx-images/incidentio-attach-post-NLGHAMBH.png)

### [In Sentry](#in-sentry)

To attach a Sentry issue to an incident in [sentry.io](https://sentry.io), navigate to a specific Sentry issue and find the "Linked Issues" section on the right panel. Click "Link incident.io issue" and select your active incident from the dropdown:

[![incident.io issue link modal in sentry.io](/_next/image/?url=%2Fmdx-images%2Fincidentio-link-issue-L6R42MPL.png%231244x616\&w=3840\&q=75)](/mdx-images/incidentio-link-issue-L6R42MPL.png)

## [Issue Sync](#issue-sync)

The incident's Slack channel will be updated with attached Sentry issue comments, edited comments, and when the Sentry issue is resolved:

[![Synced comments from Sentry on an incident in Slack](/_next/image/?url=%2Fmdx-images%2Fincidentio-issue-sync-NAF4GDK2.png%23962x256\&w=2048\&q=75)](/mdx-images/incidentio-issue-sync-NAF4GDK2.png)

## [Alerting](#alerting)

Once installed, you can also set Sentry to be an alert source for incidents.

[![incident.io alert setup](/_next/image/?url=%2Fmdx-images%2Fincidentio-alert-setup-UPDTG55H.png%231350x585\&w=3840\&q=75)](/mdx-images/incidentio-alert-setup-UPDTG55H.png)

Afterward, within Sentry you can connect it to that newly created source in an alert rule.

[![incident.io alert rule](/_next/image/?url=%2Fmdx-images%2Fincidentio-alert-rule-TOIEGIOB.png%231712x732\&w=3840\&q=75)](/mdx-images/incidentio-alert-rule-TOIEGIOB.png)

When the alert fires, it'll create an incident on incident.io, with all the downstream affects you set up on that side.
