> 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/planning-your-experience.md).

# Schedule, recurrence and priority

Reference for the When settings: start and expiration dates, recurrence options, and priority between live experiences.

The reference for the three settings of When that belong to each experience. For which combination to pick, start from [When](/docs/publish/trigger-at-the-right-time-when.md#frequent-combinations).

***

## Start and expiration

Under **Select when the experience is live**, two dates: when it goes live, and when it expires.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fx2gxez1Vztr24kXQnfNG%2FB-s07-start-date.png?alt=media&amp;token=1cdc9581-25a9-4e28-a7ea-db2b65e82366" alt="Select when the experience is live, with the chips Goes live on the 02/11/2026 at 9:00 and Expires the 01/01/2027 at 0:00"><figcaption></figcaption></figure>

#### Start date

By default an experience starts when you publish it. Set a start date and time in the future to publish now and go live later, without coming back to it on the day: the usual choice for a campaign. Until then the experience reads as **Scheduled** in the dashboard.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FT9zLZi87kRAj71IDcvTl%2FScheduleCalendar.png?alt=media&amp;token=7e6b822f-3d11-4153-8a03-989f8da051a3" alt="Calendar to pick the start date and time"><figcaption></figcaption></figure>

{% hint style="info" %}
**Back to "now".** Clear the start date with its cross to make the experience live as soon as it is published.

<img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F3xk98ICxmNYzWqNAOVLe%2FRemoveSchedule.png?alt=media&amp;token=2c84d37b-d9f5-47be-b27e-771ee04e4d37" alt="Start date with its cross to clear it" data-size="original"><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FX7jGOo0x0VIcJzsMad1R%2FNow.png?alt=media&amp;token=11c6f899-d304-4b8f-b3ca-7a3a1710e840" alt="Start set to Now" data-size="original">
{% endhint %}

#### Expiration date

By default an experience runs with no end. Set an expiration date for a campaign, a feature release or a time-limited offer. At that date the experience is paused.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FkxuaXhtH2q0yYyCbFIUh%2FExpirationDateCalendar.png?alt=media&amp;token=9b8a29ec-6ee0-4d28-85ab-0f0baad3d24f" alt="Calendar to pick the expiration date"><figcaption></figcaption></figure>

{% hint style="warning" %}
**Removing an expiration date does not restart an expired experience.** It stays paused. Set it live again from the dashboard, where you can pause and restart any published experience.

<img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FHyPXy6g2ofxka8eq9Pbm%2FB-s18-dashboard-pause-shortcut.png?alt=media&amp;token=753705b2-dbf3-4d2e-ba5a-c51b98ff5a2e" alt="Actions shown when you hover a live experience in the dashboard: Pause, Edit, Settings, Duplicate, Add to space and Delete, with Pause highlighted" data-size="original">
{% endhint %}

## Recurrence

Under **Select experience recurrence**: how often the same user can see the experience again.

#### Show once

The default, and the safe choice: users who skipped the experience are not asked again. A user who has seen the experience does not see it again. The right choice for welcome messages, announcements and most tours.

What counts is the first step: the experience is done for a user once they have seen or completed its first step. The exact moment can vary with the kind of first step: a modal, a snippet, a tooltip or a hotspot.

#### Show every

**Show every** \[N] \[unit]: the experience can show again after the number and unit you set. Use it for reminders, a survey you repeat, or an announcement you know comes back, for example every 90 days for an NPS. Your assistant can set the interval in days, weeks or months.

#### Show every time

The experience shows each time the user meets the trigger. Useful while you test, for persistent guidance, or for a light hint on a page users come back to. Rarely right for a modal. Switch it back before you widen Who, see [When](/docs/publish/trigger-at-the-right-time-when.md#frequent-combinations).

{% hint style="info" %}
When does not apply to an experience with No automatic trigger: it shows each time another experience launches it. An experience On shared URL shows each time the link is opened. See [Show on](/docs/publish/trigger-on-the-right-spot-show-on.md).
{% endhint %}

## Priority

Under **Select experience priority**. When several experiences are eligible on the same page at the same time, usually because they target the same URL, the one with the highest priority shows first. A new experience has priority 0. Give a higher number to the one that must win: an experience with priority 10 shows before one with priority 9, for example 10 for a billing notice and 0 for the rest.

Under the field, the help text reads "Experiences with higher priority will be shown first", above the list of your experiences and their priority, so you can place the new one among them.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fd0nWvlCRG7QLZ3mCWDu4%2FB-s10-rate-limiting-toggle.png?alt=media&amp;token=f09a93b1-eadd-43e0-a4a0-5ba646b87e51" alt="Select experience priority in When with Rate limiting checked and priority 5, above the note Experiences with higher priority will be shown first and the list of experiences"><figcaption></figcaption></figure>

The **Rate limiting** checkbox sits in the same block. It is covered in [Rate limiting](/docs/publish/trigger-at-the-right-time-when/rate-limiting-prevent-overwhelming-users.md).

## How the three combine with rate limiting

Each setting answers a different question for the same user, on the same page.

| Question                                      | Decided by                                                                                                              |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Is the experience live right now?             | Start and expiration                                                                                                    |
| Can this user see it again?                   | Recurrence                                                                                                              |
| Several are eligible: which one goes first?   | Priority                                                                                                                |
| This user just saw one: can they see another? | [Rate limiting](/docs/publish/trigger-at-the-right-time-when/rate-limiting-prevent-overwhelming-users.md), project-wide |

<details>

<summary>Best practices</summary>

* **Timing.** Launch when your users are most active, or when they are least busy, based on your analytics.
* **Test timings.** Try different moments, and keep the one that engages most.
* **Schedule campaigns.** A start date makes a promotion go live on time without anyone at the keyboard.
* **Repeat what must be seen.** For an important announcement or a compliance notice, a recurrence reaches users who missed it the first time.
* **Review priorities.** Adjust them when your goals change, or after user feedback.
* **Mind the cap.** Tune [rate limiting](/docs/publish/trigger-at-the-right-time-when/rate-limiting-prevent-overwhelming-users.md) to keep users from seeing too many experiences.

</details>

## From your assistant

Ask: *"Show the Welcome modal again every 2 weeks, priority 10."* The preview shows the current and the new recurrence and priority before anything changes. More in [What to ask?](/docs/integrations/mcp/what-to-ask.md)

## Related

* [When: schedule and frequency](/docs/publish/trigger-at-the-right-time-when.md)
* [Rate limiting](/docs/publish/trigger-at-the-right-time-when/rate-limiting-prevent-overwhelming-users.md)
* [Test safely](/docs/getting-started/publish-your-first-experience/test-safely.md): reset what your browser has seen.
