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.

Maintenance vs Incidents
| Maintenance | Incidents |
|---|---|
| Planned in advance | Unexpected issues |
| Scheduled start/end time | Duration unknown at start |
| Proactive communication | Reactive communication |
| Users can prepare | Users 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
- Go to Maintenances in the left menu
- Click Schedule Maintenance
- Fill in the details:
| Field | Description |
|---|---|
| Title | What the maintenance is for |
| Description | Details about expected impact |
| Start Time | When maintenance begins |
| End Time | When you expect to finish |
| Affected Components | Which services will be impacted |
- 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:
- Subscribers can be automatically notified
- They receive advance notice before maintenance begins
- 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:
- Open the maintenance record
- Click Complete Maintenance or mark it as finished
- Components return to normal status
If you need more time, you can extend the maintenance window.
Maintenance Best Practices
| Do | Don’t |
|---|---|
| Schedule during low-traffic hours | Perform maintenance during peak times |
| Give at least 24 hours notice for major work | Surprise users with last-minute maintenance |
| Be clear about expected impact | Use vague descriptions |
| Update if plans change | Leave outdated information |
| Complete on time or extend if needed | Leave maintenance running after you’re done |
Viewing Maintenance History
To see past maintenance:
- Go to Maintenances in the left menu
- View completed, ongoing, and scheduled maintenance
- Click any entry to see details