How to create an incident
Summary
Section titled “Summary”Create an incident so you can publish it to status pages and notify subscribers.
Who can do this: Owner, Admin, or Editor. Viewers and billing-only roles cannot create incidents.
Prerequisites
Section titled “Prerequisites”At least one status page in the workspace. Services are optional but recommended for impact. See How to create a status page.
- Click New incident in the header create menu (Create new…), or open Incidents and click New incident.
- Enter the incident title and summary (publishing language tabs if you have more than one language).
- Set Incident start time (when the event actually started).
- Under publish targets, select at least one status page (Publish to).
- Optionally set Affected services, Initial impact, and Initial phase / Lifecycle status.
- Optionally expand page overrides for per-page title, summary, or first timeline entry.
- Click Create incident.
[Screenshot: New incident form with Create incident button]
Result
Section titled “Result”The incident opens on its detail page with a first timeline entry. Verified subscribers on published pages can receive email.
Troubleshooting
Section titled “Troubleshooting”- If you see Your role cannot create incidents (Viewer or Billing-only), ask an Owner to upgrade your role.
- If there are No status pages in this workspace, create a page first.
- Empty list copy notes you need at least one status page and any services you want on that page before publishing makes sense.
Related articles
Section titled “Related articles”- How to publish an incident to status pages
- How to set affected services and initial impact
- How to post an incident update
Sources (for verification)
Section titled “Sources (for verification)”src/app/admin/incidents/new/page.tsxsrc/components/admin/incidents/incident-create-form.tsxmessages/en.json → admin.newIncidentmessages/en.json → admin.incidentCreatemessages/en.json → admin.header.createMenu

