Logo
Status Page

Status Page Documentation

Common troubleshooting topics: Creating a status page, setting up a monitor, incident management, etc.

Scheduling Planned Maintenance

StatusPage.me Dec 9, 2025 Incidents & Maintenances

Scheduling Planned Maintenance

Planned maintenance is different from incidents - it’s scheduled work you know about in advance. Announcing it beforehand helps set user expectations and reduce support requests.

Schedule maintenance form


Maintenance vs Incidents

MaintenanceIncidents
Planned in advanceUnexpected issues
Scheduled start/end timeDuration unknown at start
Proactive communicationReactive communication
Users can prepareUsers are surprised

When to Schedule Maintenance

Common reasons for scheduled maintenance:

  • Database upgrades
  • Security updates
  • Server migrations
  • Infrastructure changes
  • Performance optimizations
  • Certificate renewals

If users might notice any impact, it’s worth scheduling maintenance.


Creating a Maintenance Window

  1. Go to Maintenances in the left menu
  2. Click Schedule Maintenance
  3. Fill in the details:
FieldDescription
TitleWhat the maintenance is for
DescriptionDetails about expected impact
Start TimeWhen maintenance begins
End TimeWhen you expect to finish
Affected ComponentsWhich services will be impacted
  1. Click Schedule

Setting the Time Window

Be realistic about your maintenance window:

  • Add buffer time - Things often take longer than expected
  • Consider time zones - Choose times with least user impact
  • Update if needed - Extend the window if work takes longer

The maintenance will automatically start and end at the scheduled times on your status page.


Affected Components

Select the components that will be impacted:

  • Their status automatically changes to “Under Maintenance”
  • They return to normal status when maintenance ends
  • Users can see exactly what’s affected

Notifying Subscribers

When you create a scheduled maintenance:

  1. Subscribers can be automatically notified
  2. They receive advance notice before maintenance begins
  3. Updates are sent when maintenance starts and ends

Configure notification settings in your status page settings or subscriber settings.


During Maintenance

While maintenance is in progress:

  • Your status page shows the maintenance banner
  • Affected components show maintenance status
  • Users see the expected end time

If you need to post updates during maintenance, you can add them to the maintenance record.


Completing Maintenance

Maintenance ends automatically at the scheduled end time. If you finish early:

  1. Open the maintenance record
  2. Click Complete Maintenance or mark it as finished
  3. Components return to normal status

If you need more time, you can extend the maintenance window.


Maintenance Best Practices

DoDon’t
Schedule during low-traffic hoursPerform maintenance during peak times
Give at least 24 hours notice for major workSurprise users with last-minute maintenance
Be clear about expected impactUse vague descriptions
Update if plans changeLeave outdated information
Complete on time or extend if neededLeave maintenance running after you’re done

Viewing Maintenance History

To see past maintenance:

  1. Go to Maintenances in the left menu
  2. View completed, ongoing, and scheduled maintenance
  3. Click any entry to see details

What’s Next?

Was this article helpful?

Share this article: