--- title: Maintenance page description: Serve a custom maintenance page instead of fetching content from the origin server or cache. Ideal for downtime notifications, planned maintenance, or emergency messages. image: https://developers.cloudflare.com/core-services-preview.png --- > Documentation Index > Fetch the complete documentation index at: https://developers.cloudflare.com/rules/llms.txt > Use this file to discover all available pages before exploring further. [Skip to content](#%5Ftop) # Maintenance page Serve a custom maintenance page. Ideal for downtime notifications, planned maintenance, or emergency messages. ## Snippet code JavaScript ``` // Define your customizable inputsconst statusCode = 503;const title = "We'll Be Right Back!";const message = "Our site is currently undergoing scheduled maintenance. We’re working hard to bring you a better experience. Thank you for your patience and understanding.";const estimatedTime = "1 hour";const contactEmail = "support@example.com";const contactPhone = "+1 234 567 89"; export default { async fetch(request) { // Serve the maintenance page as a response return new Response(generateMaintenancePage(), { status: statusCode, headers: { "Content-Type": "text/html", "Retry-After": "3600", // Suggest retry after 1 hour }, }); },}; function generateMaintenancePage() { return ` ${title}

${title}

${message}

If all goes to plan, we'll be back online in ${estimatedTime}. 🚀

Need help? Reach out to us at ${contactEmail} or call us at ${contactPhone}.

`;} ``` ## Snippet rule Configure a custom filter expression: | Field | Operator | Value | | ----------------- | -------------- | ---------- | | IP Source Address | is not in list | admin\_ips | If you are using the Expression Editor, enter the following expression: ``` (not ip.src in $admin_ips) ``` The [IP list](https://developers.cloudflare.com/waf/tools/lists/custom-lists/#ip-lists) `admin_ips` was previously created and contains the list of IP addresses of the site administrators, which will be able to access the site during the maintenance period. ```json {"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/rules/snippets/examples/maintenance/#page","headline":"Maintenance page · Cloudflare Rules docs","description":"Serve a custom maintenance page instead of fetching content from the origin server or cache. Ideal for downtime notifications, planned maintenance, or emergency messages.","url":"https://developers.cloudflare.com/rules/snippets/examples/maintenance/","inLanguage":"en","image":"https://developers.cloudflare.com/core-services-preview.png","dateModified":"2025-10-13","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"},"keywords":["Redirects"]} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/rules/","name":"Rules"}},{"@type":"ListItem","position":3,"item":{"@id":"/rules/snippets/","name":"Cloudflare Snippets"}},{"@type":"ListItem","position":4,"item":{"@id":"/rules/snippets/examples/","name":"Snippets examples"}},{"@type":"ListItem","position":5,"item":{"@id":"/rules/snippets/examples/maintenance/","name":"Maintenance page"}}]} ```