Skip to main content

Maintenance Windows

Maintenance windows let you communicate planned downtime before it happens. Subscribers receive advance notice, and a maintenance banner displays on the public status page throughout the window.

Scheduling a Maintenance Window​

  1. Open the status page and click the Maintenance tab
  2. Click Schedule Maintenance
  3. Fill in the form:
FieldRequiredDescription
TitleYesShort description of the work — e.g., "Scheduled Firewall Patching"
DescriptionNoLonger explanation visible on the public page — what's changing, why, and expected impact
Affected ComponentsNoWhich services will be affected; their status changes to "Maintenance" when the window starts
Scheduled StartYesWhen the maintenance begins (date and time)
Scheduled EndYesWhen the maintenance is expected to complete (date and time)
  1. Click Schedule

Subscribers are notified immediately when a maintenance window is scheduled.

💡Schedule maintenance well in advance — 24 to 72 hours is standard. This gives clients time to plan around the downtime. For emergency maintenance, schedule and notify as early as possible even if the window is only hours away.

Maintenance Lifecycle​

StatusMeaning
ScheduledMaintenance is upcoming; visible in the "Upcoming Maintenance" section of the public page
In ProgressMaintenance has started; a banner appears at the top of the public page
CompletedMaintenance finished; affected components return to Operational
CancelledMaintenance was called off; subscribers are not automatically notified of cancellation

Automatic Start and Completion​

The One Status automatically transitions maintenance windows based on the scheduled times:

  • Auto-start: When the current time reaches the Scheduled Start, the window transitions to "In Progress" automatically. Affected components are updated to Maintenance status. Subscribers are notified.
  • Auto-complete: When the current time reaches the Scheduled End, the window transitions to "Completed" automatically. Affected components return to Operational (or their pre-maintenance status). Subscribers are notified.

The automation runs on a 1-minute polling cycle. Transitions happen within 1 minute of the scheduled time.

â„šī¸Auto-completion sets affected components back to Operational. If there is an active incident affecting those components, their status will reflect the incident impact, not Operational.

Manual Start and Completion​

You can also start and complete maintenance windows manually regardless of the scheduled times:

Manual Start​

  1. In the Maintenance tab, find the scheduled maintenance
  2. Click Start — the window transitions to "In Progress" immediately

Use this when maintenance begins earlier than expected.

Manual Complete​

  1. In the Maintenance tab, find the in-progress maintenance
  2. Click Complete — the window transitions to "Completed" immediately

Use this when maintenance finishes earlier than the scheduled end time.

Cancelling a Maintenance Window​

If planned maintenance is called off:

  1. In the Maintenance tab, find the scheduled maintenance
  2. Click Cancel

The maintenance window transitions to "Cancelled" and is removed from the upcoming maintenance section of the public page. Subscribers are not automatically notified. If clients need to know the maintenance is cancelled, post a notice separately.

Public Page Display​

While a maintenance window is in progress:

  • A blue maintenance banner appears at the top of the public page: "Scheduled maintenance is currently in progress"
  • The maintenance window appears in the active maintenance section with title, description, and expected completion time
  • Affected components show "Maintenance" status (blue indicator)

Upcoming (scheduled) maintenance appears in a separate section with the scheduled date and time.

Subscriber Notifications​

EventNotification Sent
Maintenance scheduledYes — immediate notification to all subscribers following affected components
Maintenance started (auto or manual)Yes — immediate notification
Maintenance completed (auto or manual)Yes — immediate notification
Maintenance cancelledNo — no automatic notification

Subscribers on Daily Digest or Weekly Digest frequency receive maintenance events in their next digest, not immediately.

Editing a Scheduled Maintenance​

Click Edit on a scheduled maintenance window to update the title, description, affected components, or times. Changes are saved immediately and the public page updates. Subscribers are not re-notified of edits to already-scheduled maintenance.

Deleting a Maintenance Window​

Click Delete to remove a maintenance window. Completed maintenance windows are kept in history for the configured history period. You can delete them manually if needed.

💡Completed maintenance windows appear in the incident history section of the public page, giving clients a record of all planned changes. This is valuable for compliance-conscious clients.