Status Pages

Scheduled Maintenance

Maintenance windows let you communicate planned downtime in advance so your users know what to expect and when. This page covers creating, managing, and understanding how maintenance events appear on the public status page.

Creating a maintenance window

Navigate to your status page in the dashboard and click Schedule Maintenance. Fill in the following:

Field	Description
`title`	A short description of the maintenance, e.g. "Database upgrade to PostgreSQL 16".
`message`	Detailed description of what will happen and expected impact.
`starts_at`	When the maintenance window begins.
`ends_at`	When the maintenance window is expected to end.
`components`	Optionally select which components will be affected during maintenance.

Times are entered in the timezone configured for the status page. Beacon converts and stores them in UTC internally.

Maintenance states

A maintenance event transitions through the following states:

State	Description
`scheduled`	The maintenance has been created but the start time has not arrived. This is the initial state.
`in_progress`	The maintenance window is currently active. Affected components are automatically set to the maintenance status.
`completed`	The maintenance finished successfully. Affected components are restored to operational.
`cancelled`	The maintenance was called off before or during execution.

scheduled  -->  in_progress  -->  completed
    |                     |
    +-------->  cancelled  <--------+

Beacon automatically transitions from scheduled to in_progress when the start time arrives, and from in_progress to completed when the end time passes. You can also trigger these transitions manually from the dashboard.

How maintenance appears on the public page

Maintenance events are displayed in a dedicated section on the public status page, separate from incidents. The section shows:

The maintenance title and message.
The scheduled start and end times, displayed in the page timezone.
The current state (scheduled, in progress, completed, or cancelled).
The affected components, if specified.

When maintenance is in progress, affected components display a blue "Maintenance" badge instead of their normal status indicator.

Visibility rules

To keep the public page clean, maintenance events are only visible when they are relevant:

Upcoming — Shown if starts_at is within the next 1 day.
In progress — Always shown while the maintenance is active.
Recently completed — Shown if ends_at is within the past 7 days.

Maintenance events outside these windows are hidden from the public page but remain accessible in the dashboard for historical reference.

Cancelled maintenance events follow the same visibility rules. They remain visible for the applicable window so visitors can see the cancellation notice.

Plan limits

The number of active (scheduled or in-progress) maintenance windows per status page varies by plan:

Plan	Active maintenance windows
Free	2
Pro	10
Business	50
Enterprise	Unlimited

Completed and cancelled maintenance events do not count toward the limit. There is no limit on historical maintenance records.