From 4d1810f72b21d82f59b288319b6b1a9bbfea300f Mon Sep 17 00:00:00 2001 From: Scott Pearson Date: Thu, 4 Jun 2026 11:14:09 +0100 Subject: [PATCH 1/2] Update maintenance-mode.mdx --- .../docs/fundamentals/performance/maintenance-mode.mdx | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/content/docs/fundamentals/performance/maintenance-mode.mdx b/src/content/docs/fundamentals/performance/maintenance-mode.mdx index 5952ce57f16..03987ba3791 100644 --- a/src/content/docs/fundamentals/performance/maintenance-mode.mdx +++ b/src/content/docs/fundamentals/performance/maintenance-mode.mdx @@ -22,6 +22,11 @@ For a maintenance page without code, Business and Enterprise uses can create a [ Certain customization and queue options depend on your [plan](/waiting-room/plans/). +:::caution +Waiting Room configuration can take up to a few minutes to propagate across Cloudflare's network after initial creation. It is not recommended for scenarios where an immediate response is required. +Additionally, Waiting Room does not affect users who are already active on your site at the time it is enabled as only new incoming requests will be queued. +::: + ![Waiting room page returned instead of your website](~/assets/images/fundamentals/waiting-room-page.png) ### All plans From 38e5174992ca4b4d66cff0d7d61b57261b7a5045 Mon Sep 17 00:00:00 2001 From: Scott Pearson Date: Thu, 4 Jun 2026 11:28:23 +0100 Subject: [PATCH 2/2] Update create-events.mdx https://jira.cfdata.org/browse/PCX-21868 --- .../docs/waiting-room/additional-options/create-events.mdx | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/content/docs/waiting-room/additional-options/create-events.mdx b/src/content/docs/waiting-room/additional-options/create-events.mdx index 123834ddd12..22928c917a4 100644 --- a/src/content/docs/waiting-room/additional-options/create-events.mdx +++ b/src/content/docs/waiting-room/additional-options/create-events.mdx @@ -127,6 +127,12 @@ Follow these steps if you would like to deploy a scheduled maintenance page, wit After the scheduled event has ended, users will have access to your site. You can end the maintenance window before the scheduled event is over by setting the event to disabled. +:::caution +This approach is intended for **scheduled** maintenance windows configured in advance. Waiting Room configuration can take up to a few minutes to propagate across Cloudflare's network after initial creation, so it is not recommended for scenarios where an immediate response is required. Additionally, the Reject method will not affect users who are already active on your site at the time it is enabled, only new users will be queued. + +For unplanned maintenance requiring an immediate response, consider using a [Workers snippet](/rules/snippets/examples/maintenance/) to serve a maintenance page instead. +::: + ## Other API commands | Function | Command |