> 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.md).

# When: schedule and frequency

Set when an experience goes live and ends, how often a user sees it, which one wins when several compete, and how rate limiting spaces them out.

**When** sets the life of an experience: the dates it runs between, how often the same user sees it, and its priority against other live experiences. Rate limiting, a project-wide cap, decides how close together two experiences can reach the same user.

**You will have at the end:** a frequency that fits the message, and the right reflex when an experience does not come back.

***

## The four settings

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FBdt6GlSaCVgB7u9dICho%2FB-04-when-timeline.png?alt=media" alt="Timeline of one user from start to expiry: the experience shows again after each recurrence and is paused at expiry, while another experience held by the rate limit waits, then shows"><figcaption></figcaption></figure>

| Setting              | What it does                                                            | Default                            |
| -------------------- | ----------------------------------------------------------------------- | ---------------------------------- |
| Start and expiration | The dates between which the experience runs                             | Starts at publication, no end date |
| Recurrence           | How often the same user sees it again                                   | **Show once**                      |
| Priority             | Which experience shows first when several are eligible on the same page | 0, higher shows first              |
| Rate limiting        | Respects or ignores the project-wide cap                                | Respected                          |

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F3EWpoCL8XktgM0kcSOBv%2FB-s06-when-section.png?alt=media&amp;token=73451466-8d21-4c99-887b-50a6ef9fc318" alt="When section: Goes live on the 02/11/2026 at 9:00 and Expires the 01/01/2027 at 0:00, recurrence Show every 7 Day selected between Show once and Show every time, Rate limiting checked with priority 5, and the list of experiences with their priority"><figcaption></figcaption></figure>

Each setting is detailed in [Schedule, recurrence and priority](https://help.usejimo.com/docs/publish/trigger-at-the-right-time-when/planning-your-experience.md) and [Rate limiting](https://help.usejimo.com/docs/publish/trigger-at-the-right-time-when/rate-limiting-prevent-overwhelming-users.md).

## Frequent combinations

| Use case                               | Show on                     | Recurrence         | Who                            | Other settings                                              |
| -------------------------------------- | --------------------------- | ------------------ | ------------------------------ | ----------------------------------------------------------- |
| Welcome tour for new users             | On page opening             | Show once          | A segment of new users         |                                                             |
| Show again to users who did not finish | On page opening             | Show every N days  | This experience, not completed | Make sure leaving the tour dismisses it                     |
| NPS every quarter                      | On page opening or On event | Show every 90 days | Active users                   |                                                             |
| Campaign with an end                   | On page opening             | Show once          | Target audience                | Start and expiration dates                                  |
| Notice everyone must see               | On page opening             | Show once          | All users                      | Priority above the others, rate limiting ignored            |
| Help offered at each visit of a page   | On page opening             | Show every time    | Target audience                | Keep it light: a hint or a banner                           |
| Second step of a journey               | No automatic trigger        | Does not apply     | Not set                        | Launched by the first experience, which decides who sees it |
| Testing before launch                  | Any                         | Show every time    | Your team segment              | Rate limiting ignored, both reset before launch             |

{% hint style="warning" %}
**Show every time and rate limiting off are test settings.** Switch them back before you widen Who: a popup that comes back at every page load, outside any cap, is the fastest way to annoy users.
{% endhint %}

## Why it did not show again

#### Recurrence is Show once

The user saw it, so it will not come back. Clear your own history with **Reset my user activities** in the Troubleshoot tool, see [Test safely](https://help.usejimo.com/docs/getting-started/publish-your-first-experience/test-safely.md).

#### Rate limiting held it back

Another experience reached the same user within the cap. The experience waits, and shows once the window has passed. See [Rate limiting](https://help.usejimo.com/docs/publish/trigger-at-the-right-time-when/rate-limiting-prevent-overwhelming-users.md).

#### It expired

At the expiration date the experience is paused. Removing the date afterwards does not restart it: set it live again from the dashboard.

#### Another one has a higher priority

When several experiences are eligible on the same page, the one with the highest priority shows first. See [Priority](https://help.usejimo.com/docs/publish/trigger-at-the-right-time-when/planning-your-experience.md#priority).

## From your assistant

Ask: *"Show the Billing banner every 7 days, from 2 November to 31 December, with priority 5."* The assistant sets the frequency and priority with the display rules, and the dates with the audience, each with a preview first. More in [What to ask?](https://help.usejimo.com/docs/integrations/mcp/what-to-ask.md)

## Verify

* In the Troubleshoot tool, an experience held back by its frequency is **Seen**, one held back by rate limiting is **Waiting** with rate limiting listed.
* A scheduled experience appears as **Scheduled** in the dashboard until its start date.

## Go further

* [Schedule, recurrence and priority](https://help.usejimo.com/docs/publish/trigger-at-the-right-time-when/planning-your-experience.md)
* [Rate limiting](https://help.usejimo.com/docs/publish/trigger-at-the-right-time-when/rate-limiting-prevent-overwhelming-users.md)
* [Why my experience does not show](https://help.usejimo.com/docs/getting-started/publish-your-first-experience/why-my-experience-does-not-show.md), causes 1, 2 and 8.
* [In-app tour of When](https://i.usejimo.com/tours?jimo_poke=ecd1588a-24d9-4070-82ee-5a1d699d595e): opens a guided tour of the section in your Jimo dashboard.

**Next page:** [Goal: measure outcomes](https://help.usejimo.com/docs/publish/mesure-outcomes-goal.md)
