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
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  |