Show maintenance windows on your status page

View as Markdown

A maintenance window can do more than hold back alerts: it can tell your status page visitors that downtime is planned. With Show on status page on, a window appears automatically on every one of your status pages that shows a monitor the window covers. There is no separate “add to status page” step.

What visitors see

When	How it appears
Starts within the next 7 days	A blue maintenance panel near the top of the page, with the window’s name, its times and the affected components.
In progress	The same panel marked as in progress. A component that is down during the window shows as under maintenance instead of down.
In the last 90 days	The days it covered are drawn in blue on the affected components’ uptime bars, so a planned deploy does not read as an unexplained dip.

Rules behind that display:

Only components backed by one of the window’s monitors are affected. Third-party components (ones you set by hand) never pick up a maintenance window.
A day is drawn blue only when no other component had a real problem that day - blue never hides a real outage.
If you also declared a scheduled maintenance on the page for the same period, the page shows your declared one instead of a duplicate.
The machine-readable status.json of the page lists upcoming and in-progress windows in its scheduledMaintenances array (id, title, status, scheduledStart, scheduledEnd), and reports a covered component that is down as "maint". See Embeds, badges and exports.
Weekly windows show each occurrence that falls inside those horizons.

Settings reference

Setting (UI label)	API field	Type	Default	What it does for you
Show on status page	`showOnStatusPage`	`true` / `false`	`true`	Shows or hides this window on all your status pages. Presentation only - suppression of alerts and statistics is unchanged.

The switch is per window. There is no page-level setting that hides every window, and no way to show a window on one status page but not another: it appears on every page that includes one of its monitors.

Turn it on or off in the app

Open Maintenance in the sidebar and click the gear on the window (or Add for a new one).
Under Schedule, find Show on status page and switch it on (visitors see it) or off (internal only - an internal check, a window customers should not hear about).
Click Save. Public pages pick up the change within a couple of minutes (status pages cache briefly).

Do it with the API or MCP

curl -X PATCH https://api2.host-tracker.com/maintenance/MAINTENANCE_ID \
  -H "Authorization: Bearer $HT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "showOnStatusPage": false }'

Send "showOnStatusPage": true or false on POST /maintenance to set it at creation (scope monitor:write).

The MCP create_maintenance and update_maintenance tools have no showOnStatusPage argument, so windows they create are shown by default. To change the flag from an assistant, use api_request with PATCH /maintenance/{id}.

Record maintenance after the fact

Did a planned change go ahead without a window, and now the status page shows red days? Create a window for the past period through the API - POST /maintenance accepts a from in the past - covering the affected monitors, with Show on status page on. The covered days turn blue on the uptime bars (within the last 90 days).

A window created afterwards cannot un-send alerts that already went out. Whether it also changes the uptime figures in your own reports for that period is not something to rely on - its purpose is the public display.

The editor in the app does not accept a one-time start date before today, so backdating is an API task.

Status page announcements for the same event

A window shows your window’s name and times. To tell subscribers more - what you are doing, the expected impact - also declare a scheduled maintenance on the status page. It is sent to the page’s subscribers, which a window alone is not. See Post announcements and incident updates.