Frequency & triggers
A trigger decides when a flow shows; frequency decides how often it may re-appear. Together they keep flows helpful without being annoying.
Triggers - when a flow shows
| Trigger | When it fires |
|---|---|
| Load | As soon as the page loads and targeting passes (the default). |
| Delay | After a set number of seconds. |
| Scroll | Once the user scrolls past a threshold. |
| Click | When the user clicks a specific element - an explicit, user-initiated open. |
| Manual | Waits for your code to call onbixo.show(flowId). |
A click or manual trigger is treated as the user asking for the flow, so it is not blocked by the "already dismissed" rule - though targeting and frequency caps still apply.
Frequency - how often it repeats
The show-again cadence decides when a flow may return after it has shown:
| Cadence | Behavior |
|---|---|
| Once per session (default) | Shows at most once per browsing session. A session ends after 30+ minutes of inactivity, so it can return on a later visit but will not repeat within one sitting. |
| Once | Shows a single time, then never again for that user. |
| Once per pageview | May show again on each new page load (subject to targeting and the baseline rule below). Use sparingly - it is the most repetitive option. |
| Every N (interval) | Shows again only after a set period - minutes, hours, or days - has passed since it last appeared. This is the "cooldown" option. |
The baseline rule
On top of the cadence, a flow that a user has already completed or dismissed does not auto-show again - the same way a finished tour stays closed. (A click or manual trigger is the user asking for it, so it bypasses this.) The baseline always applies, whichever cadence you pick.
Frequency is tracked per device in the browser's local storage. It resets if the user clears storage or moves to a new device - a deliberate trade-off that keeps the runtime fast and free of extra server calls.
For a one-time announcement, use the Once cadence. For a nudge you want to repeat occasionally, use Every N (interval) so it returns without nagging. The once per session default suits most flows.
Last updated: Aug 17, 2026