Glossary · Monitoring

Maintenance Window

A maintenance window is a pre-announced period set aside for changes such as upgrades or migrations, during which brief downtime is expected.

Updated October 6, 2026

A maintenance window is a scheduled time when a team performs planned work on a system, such as patching servers, upgrading a database or moving to new hosting. Users are told in advance that the service may be unavailable or slower.

Why it matters

Planning changes for low-traffic hours and announcing them reduces surprise and customer impact. Monitoring should know about the window too: otherwise it sends alerts for expected downtime and records it in uptime reports. Many SLAs exclude properly announced maintenance from availability calculations, though the terms differ by contract.

Example

Window:   Sunday 02:00-03:00 UTC
Work:     database major version upgrade
Rollback: restore from snapshot if not healthy by 02:45
Notice:   status page post 7 days before, reminder 24 hours before

During the window the monitor is paused or tagged as maintenance, and the site shows an HTTP 503 page with a Retry-After header.

Common mistakes

  • Forgetting to pause alerts, so on-call is paged for planned work.
  • Overrunning the window with no rollback decision point.
  • Serving 200 on a maintenance page, which search engines may index. Use 503.
  • Leaving monitors paused after the work is finished.

Get notified when this term updates

Plus occasional practical tips on uptime and monitoring, nothing else. Unsubscribe anytime.

Keep reading

Glossary · MonitoringPlanned DowntimePlanned downtime is a scheduled period when a service is intentionally unavailable or degraded for maintenance, upgrades or migrations.Guide · MonitoringStatus Page Message Templates: Incident and Maintenance ExamplesCopy-ready status page messages for investigating, identified, monitoring and resolved updates and planned maintenance, with tone rules and worked examples.8 min readGuide · Downtime & Errors503 Service Unavailable: What It Means and How to Fix It Step by StepDiagnose a 503 Service Unavailable error from overload, maintenance mode, exhausted workers or a dead backend, with fixes for WordPress, nginx, Apache and IIS.8 min readError fix · Server errorsHTTP 503 Retry-After and Maintenance Pages: Doing It RightServe a proper 503 Service Unavailable with a Retry-After header for maintenance windows, with nginx, Apache and CDN examples and notes on SEO and caching.4 min readGlossary · MonitoringAlert (Monitoring)A monitoring alert is an automatic notification sent when a check or metric crosses a defined condition, such as a site failing to respond.Glossary · MonitoringAlert DeduplicationAlert deduplication merges repeated alerts about the same underlying problem into one incident, so responders are notified once rather than hundreds of times.

This page is general information written by our editorial team and updated when documentation changes. Servers and providers differ, so test changes safely first. See our editorial policy and disclaimer.