Scheduling a maintenance window in the dashboard
Prerequisites
- A status page. The window appears on it whether or not the page is published, but customers only see it once the page is live.
- The components the work affects, in your catalog.
- A signed-in scaling.cloud account in the organization.
Schedule a window
1
Open status page settings
Go to Settings → Status Page in the scaling.cloud dashboard and find the Scheduled maintenance section.
2
Click “Schedule maintenance”
This opens the maintenance form.
3
Write the notice
- Title — a short summary customers will read, e.g.
Database engine upgrade. - Details — the body of the notice. Markdown is supported and it’s shown publicly, so link to a tracking issue or list the expected impact. Headings, bold/italic, lists, and links all render; anything unsafe is stripped automatically.
4
Set the time window
Pick a Starts at and Ends at in your local time. The end must be after the start.
5
Select affected components
Tick the components the work touches. While the window is active, each shows as maintenance on the page (unless an incident or override is already worse on that component), and the overall banner reads Under maintenance.
6
Schedule it
Click Schedule. The window appears in the list as Scheduled, and — once your page is published — in the Scheduled Maintenance section of the public page as Upcoming.
Manage the window
Each window in the list shows its state and offers the actions valid for that state:- Edit — change the title, body, time window, or affected components. Allowed while the window is
scheduledorin_progress; terminal windows can’t be edited. - Start — mark the work as begun (moves to In progress).
- Complete — mark the work as finished (moves to Completed). It stays on the public page for 48 hours, then drops off.
- Cancel — call the work off. A cancelled window is removed from the public page immediately and never shown again.
Start and Complete are about your own workflow and timing — the public page already reflects the window by its clock times. Use them to mark reality and (in future) to time customer notifications precisely.
Verify it
Open your status page in an incognito window (no account needed) and confirm:- The window appears in the Scheduled Maintenance section with the right state (Upcoming before the start, In Progress during).
- The body renders as you intended — links work, lists are formatted.
- During the window, the affected components show maintenance and the banner reads Under maintenance (unless a real incident outranks it).
Next steps
- Scheduled maintenance — the full model: lifecycle, public states, banner behaviour, and the JSON feed shape.
- Connect a custom domain so the page is served at
status.example.com.