Sign In

Creating & Editing Incidents

Declare new incidents and keep them updated as your team investigates and resolves issues.

In Upstat, incidents are central to how your team responds to unplanned events. This guide explains how to create an incident, update its status, and manage its details in real time.

Declaring an Incident

You can declare a new incident at any time by:

  1. Clicking New Incident from the top of the Incidents section
  2. Filling out the incident form:

Fields to Complete

  • Title — A short, descriptive label (e.g., “API latency spike in us-east”)
  • Severity — Choose from custom severity levels configured in your project
  • Status — Select the initial status (e.g., Identified, Investigating)
  • Lead — Assign a user as the Incident Lead
  • Labels — Optional tags for filtering and categorization (e.g., database, customer-impacting)
  • Linked Monitors — Attach one or more monitors that relate to this incident
  • Summary — Use the rich text editor (with Markdown support) to add context

![Placeholder: New Incident Screenshot]

Editing an Incident

To update an incident:

  1. Click on the incident card or row from the Kanban or List View
  2. Use the right-hand detail panel to:
    • Update status, severity, or lead
    • Add or remove labels
    • Edit the summary
    • Link to catalog entities (like services or customers)

Changes are saved automatically.

![Placeholder: Incident Detail Screenshot]

Markdown Support

The summary field and comment threads both support full Markdown syntax, including:

  • Headings and lists
  • Code blocks
  • Links and inline images
  • Task checkboxes

This allows for structured updates and live documentation during response.

Summary

  • Incidents can be declared at any time via the “New Incident” button
  • You can edit incidents inline from the Kanban or List view
  • All updates are saved in real time and reflected across the team
  • The rich text editor supports Markdown for clear, structured communication

Learn more