> For the complete documentation index, see [llms.txt](https://help.usejimo.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.usejimo.com/docs/publish/trigger-at-the-right-time-when/rate-limiting-prevent-overwhelming-users.md).

# 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**.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F1FUs610M5bwiug9Lyhp1%2Frate-01-unit-dropdown-hours-days.png?alt=media&amp;token=68be2b9f-0337-43b4-a784-fcee1444ea13" alt="Rate limit card in Settings > Rate Display Limit with the unit dropdown open, showing the two options Days and Hours"><figcaption><p>The unit dropdown offers Days and Hours.</p></figcaption></figure>

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fvcc2UueQM8rZueB5Zepi%2FB-s09-rate-limiting-settings.png?alt=media&amp;token=ef77114d-c5d6-44a4-9b14-92f40f207419" alt="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"><figcaption></figcaption></figure>

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

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FLJj9ZW1quAzVMhB45Ljh%2FB-06-rate-limit-window.png?alt=media&amp;token=01be971b-ba82-4546-b7ff-956e4ef1f742" alt="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"><figcaption></figcaption></figure>

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

{% tabs %}
{% tab title="From the experience" %}
In the **When** section of the experience, uncheck **Rate limiting** under **Select experience priority**. Checked, the experience respects the cap; unchecked, it ignores it.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FjZZF0DmdP8GisrZAHJfD%2FB-s08-priority.png?alt=media&amp;token=03599314-faf6-46f0-aafb-af239b7cb540" alt="Select experience priority: Rate limiting checked, the priority field set to 5 and the Priority label with an info icon"><figcaption></figcaption></figure>

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

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FvJBPRjbW14l1ciXlIEAt%2FB-s16-rate-limiting-exclude-warning.png?alt=media&amp;token=2f8c9062-233e-4ce7-9230-afc377638516" alt="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"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="From Settings" %}
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.
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
**Turn it back on after testing.** Rate limiting is the usual reason a second experience does not show during a test session. Turning it off for the test is fine; leaving it off for everyone is not.
{% endhint %}

## 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](https://help.usejimo.com/docs/getting-started/publish-your-first-experience/why-my-experience-does-not-show.md), cause 2.

## Related

* [When: schedule and frequency](https://help.usejimo.com/docs/publish/trigger-at-the-right-time-when.md)
* [Schedule, recurrence and priority](https://help.usejimo.com/docs/publish/trigger-at-the-right-time-when/planning-your-experience.md)
* [Test safely](https://help.usejimo.com/docs/getting-started/publish-your-first-experience/test-safely.md)
