Skip to main content

How do maintenance windows work?

A maintenance window is similar to an unscheduled incident, but with a few differences:
  • It must have a set time window which confirms when you expect components to not be working as normal.
  • Scheduled maintenance windows appear in your status page in advance, to help your customers plan around it.
  • Optionally, maintenance windows can progress to ‘in progress’ at the start time, and then to ‘completed’ at the end of the maintenance window. Automated updates will not notify your subscribers. If you disable this, you’ll need to manually update the status of the maintenance window when it is in progress and when it is completed.
‘In progress’ maintenance windows will appear on your status page as ongoing issues for your customers to be aware of.

How do I schedule a maintenance window?

Scheduled maintenance is only available for your public-facing status pages - internal pages cannot currently have scheduled maintenance added to them.
Navigate to Status pages in your left-hand menu, and select the status page you want to add scheduled maintenance to. Then, click in to the Maintenance tab: The Maintenance tab of a status page, with an empty Maintenance windows panel In the top-right of your screen, you’ll now see a Schedule maintenance button: The Schedule maintenance button highlighted in the top-right of the status page Click this to open up the form: The Maintenance details step, with Name, Automate status updates, Impact window, Message and Affected components This is similar to the ‘publish incident’ flow, but there’s a few differences. Let’s walk through the form.
  1. First choose a name : we’ll use this anywhere that links to this maintenance window, and as the subject line in any emails to subscribers.
  2. Next choose whether to automate this maintenance.
By default, we’ll automatically update your maintenance window to be ‘in progress’ at the scheduled start time, and to ‘completed’ at the scheduled end time.
  1. Now set the Impact window: the start and end time of the maintenance.
  2. The message is where you explain the anticipated impact of this maintenance event.
This will be shown on the status page for this maintenance window, and optionally sent to your subscribers.
  1. Finally choose the Affected components.
This helps your customers understand whether they’ll be impacted by this maintenance event.
As with an unscheduled incident, click ‘Review’ to double-check before you publish to your status page. The Review & publish step summarising the Database upgrade window, its schedule and affected components