How do I post an incident update on my status page?

Status page updates let you communicate with your users during an incident (or planned maintenance) without waiting for your monitoring to do the talking.

Posting an update

1. Open your status page.
2. Click Post update.
3. Pick a status for the update: Investigating, Identified, Monitoring, Resolved, or Scheduled.
4. Write a short summary for the title and a longer explanation for the body.
5. Optionally, link the update to one or more specific monitors so readers know exactly what's affected.
6. Publish.

Subscribers (see the next section) are notified automatically. Visitors on your status page see the update prominently at the top of the page.

Incident workflow

A typical incident timeline looks like this:

1. Investigating: "We're seeing elevated error rates and looking into it."
2. Identified: "Root cause identified as a database replica failure, failing over now."
3. Monitoring: "The failover completed, we're watching for any remaining errors."
4. Resolved: "The issue is fully resolved. Apologies for the disruption."

Each update appends to the same incident, so the full timeline is visible to visitors after the fact.

Scheduled maintenance

For planned work, use the Scheduled status instead of Investigating. You can post the update days or weeks in advance so subscribers see it before the work begins.

Posting status page updates through the API

You can also post status page updates via our API, which is great for automating post-incident updates from your deploy pipeline or internal incident management tool.