For the complete documentation index, see llms.txt. This page is also available as Markdown.

Rate limiting

Cap how many experiences one user can see in a given time, and exclude the experiences that must show regardless.

Rate limiting caps how many experiences the same user can see in a given time, across your whole project. A user who falls into several audiences then gets your experiences spaced out instead of back to back.


The project cap

Set the cap in Settings > Rate Display Limit. The Rate limit card reads Display [N] Experience(s) every [N] [unit]: the maximum number of experiences, of any type (tours, surveys, NPS, banners...), one user can see within the time span. The unit is picked from a dropdown: Hours or Days.

Rate limit card in Settings > Rate Display Limit with the unit dropdown open, showing the two options Days and Hours
The unit dropdown offers Days and Hours.
Rate Display Limit settings: the Rate limit card set to Display 1 Experience(s) every 1 Days, and the Excluded experiences card with the + Exclude experience button above three excluded experiences

How the window works

With a cap of one experience every 4 hours, a user who has just seen an experience sees no other one for 4 hours. Then the count resets. An experience held back during the window becomes eligible again: it is not lost, it waits.

With a cap of one experience per window, the first experience shows, the second waits and shows in the next window, and an excluded experience shows in the first window anyway

Exclude an experience

An experience that must show whatever the cap, such as a security notice or a terms update, can ignore rate limiting. Two ways, same result.

In the When section of the experience, uncheck Rate limiting under Select experience priority. Checked, the experience respects the cap; unchecked, it ignores it.

Select experience priority: Rate limiting checked, the priority field set to 5 and the Priority label with an info icon

A warning asks you to confirm before rate limiting is turned off.

Are you sure? dialog: You are about to exclude this experience from your rate limiting settings, with the current setting Display 1 experience(s) every 1 Days, and the buttons No and Yes, ignore it

In Settings > Rate Display Limit, in the Excluded experiences card, click + Exclude experience and pick the experience. A draft can be excluded too, before you publish it. The card lists every excluded experience.

How it shows in the Troubleshoot tool

An experience held back by the cap is listed as Waiting, with rate limiting among the conditions. See Why my experience does not show, cause 2.

Last updated