Alerts & Notifications

    Escalation Policies

    Build multi-step escalation policies so alerts reach the right person, in the right channel, at the right time.

    Updated 2026-06-15
    2 min read
    escalation
    policy
    on-call

    Escalation Policies#

    An escalation policy is an ordered list of steps. When an incident fires, LemWatch runs step 1, waits, runs step 2, waits, and keeps going until somebody acknowledges the incident or the policy runs out of steps.

    When to use one#

  1. You want different people paged at minute 0, minute 5, and minute 15
  2. You want email first, Slack second, SMS/webhook last
  3. You run on-call rotations and need a fallback if the primary doesn't ack
  4. Build a policy#

  5. Open Settings → Notifications → Escalation Policies
  6. Click New policy, give it a name (e.g. "Production on-call")
  7. Click Add step and fill in:
  8. Step order — the position in the sequence (1, 2, 3 …)
  9. Wait minutes — how long to wait before this step fires (step 1 is usually 0)
  10. Channel — email, Slack, Discord, webhook, etc.
  11. Recipient — an email address, or a webhook URL (see Step channels)
  12. Save and attach the policy to a site under Edit Site → Notifications → Escalation policy
  13. Step ordering & uniqueness#

    Each step needs a unique step_order within the policy. The editor auto-suggests the next number (max existing + 1) so adding a step after deleting one in the middle still works. If you manually enter a number that's already taken, the editor shows "Step #N already exists in this policy" instead of a raw database error.

    Acknowledging stops escalation#

    The moment any teammate clicks Acknowledge on the incident, all remaining steps are skipped. The notification engine now also skips already-acked incidents at query time, so escalation work doesn't pile up. See Acknowledging incidents.

    Editing an existing policy#

  14. Reorder steps by editing step_order values
  15. Change channel or recipient on any step
  16. Delete a step — the next save renumbers cleanly
  17. Delete the whole policy — sites that referenced it fall back to their default channels
  18. Was this article helpful?