Skip to content
Waiting Room
Visit Waiting Room on GitHub
Set theme to dark (⇧+D)

Before you begin

Before you begin to work with waiting rooms, review the prerequisites and entitlements.

Before configuring a waiting room, consider the following:

  • How you want the waiting room to operate
  • The appearance of the waiting room

Waiting room operation

First, decide which routes must be served by a waiting room. Routes are pages or applications in your website. You can link a route with only one waiting room, so you need to identify the high-traffic areas of your website. These routes are represented by the following parameters in Cloudflare Waiting Rooms:

  • Hostname - The hostname or subdomain in your zone.
  • Path (optional) - The path where you want to enable the waiting room.

Next, determine the maximum amount of traffic that you want to allow into these routes at any given time. You will use these specifications to set the following parameters for your waiting room:

  • Total active users - The total number of active user sessions allowed on the route at a point in time. Cloudflare recommends setting Total active users no higher than 80% to 85% of the traffic capacity that your origin can handle.
  • New users per minute - The number of new users admitted into the route every minute.
  • Session duration (optional) - Lifetime of a cookie set for users who get access to the route.

What your waiting room will look like

Consider the appearance of your waiting room. This is what the visitor will see when queuing to access a route. Cloudflare provides a template waiting room page to get you started, but you can edit this or upload your own HTML file. In the waiting room template, Cloudflare provides code that presents visitors with an estimated entry time to the route: including this in your waiting room page improves customer experience.

Get started

You can create, edit, delete, manage, and monitor Cloudflare Waiting Rooms using the Traffic app on the Cloudflare dashboard or with the Waiting Room API.