Skip to content

How to create an incident

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.

At least one status page in the workspace. Services are optional but recommended for impact. See How to create a status page.

  1. Click New incident in the header create menu (Create new…), or open Incidents and click New incident.
  2. Enter the incident title and summary (publishing language tabs if you have more than one language).
  3. Set Incident start time (when the event actually started).
  4. Under publish targets, select at least one status page (Publish to).
  5. Optionally set Affected services, Initial impact, and Initial phase / Lifecycle status.
  6. Optionally expand page overrides for per-page title, summary, or first timeline entry.
  7. Click Create incident.

[Screenshot: New incident form with Create incident button]

The incident opens on its detail page with a first timeline entry. Verified subscribers on published pages can receive email.

  • 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.
  • src/app/admin/incidents/new/page.tsx
  • src/components/admin/incidents/incident-create-form.tsx
  • messages/en.json → admin.newIncident
  • messages/en.json → admin.incidentCreate
  • messages/en.json → admin.header.createMenu