Skip to main content

Triggers: Overview

Covers all Promolayer display triggers and how each one works, including exit intent, idle time, scroll depth, back button capture, tab return, and cart add.

Triggers is a feature that lets you control when a display appears to visitors. Choose from built-in timing options — time on site, scroll depth, exit intent, and cart add — or use a custom trigger to fire a display at any moment via JavaScript.

How it works

A display appears when its trigger conditions are met. If multiple triggers are enabled, the display will be shown by whichever trigger is activated first. Unless the page changes or reloads, the display will only appear once, even if the trigger condition is met multiple times. The only exception is When returning to the site tab, which can display multiple times.

Options

Show immediately

Appears as soon as the page has finished loading.

Exit intent

Desktop: cursor moves to top edge or tab switch. Mobile: address bar tap, tab switch, app switch, or screen off.

Capture browser back button

Cancels back navigation and shows the display. Optional: "Landing page only" mode.

Time on site

Fires after the visitor has stayed on the page for a specified amount of time.

Idle on site

Fires after the visitor is inactive for a specified number of seconds (no mouse, keyboard, scroll, or click).

Scroll depth

Fires when the user scrolls to a specified depth on the page.

When the user scrolls up (Plus plan and above)

Fires when the user scrolls upward, typically indicating mobile address bar reveal.

When returning to the site tab (Plus plan and above)

Fires when the user returns to your tab from another tab. Can trigger multiple times per page view.

When a product is added to the cart (Shopify only)

Fires when the Add to Cart button is clicked. See Cart Add Trigger: Overview.

Custom trigger

JavaScript-based trigger for flexible display timing. Use "Get trigger code" in the Rules tab.

Show immediately

The display appears as soon as the page has finished loading.

Exit intent

The behavior is slightly different on mobile and desktop.

Mobile

  • When the address bar is tapped and the keyboard appears

  • When the user switches tabs

  • When the current browser app is no longer active

  • When the screen is turned off

Note: If the page has not been tapped even once, this trigger may not fire.

Desktop

  • When the mouse cursor moves to the top edge of the current page

  • When the user switches tabs

  • When the current browser is no longer active

Capture browser back button

When the Back button is pressed (including swipe-back gestures on mobile), the back action is canceled and the display is shown instead. If the user performs the back action again, the browser will go back normally. However, on desktop browsers, back button detection does not work on pages where the user has not clicked anything.

Alt + ← (Windows) and Command + ← (Mac) are also detected as "back" navigation actions and will trigger the popup.

Landing page only

If you enable Landing page only, the trigger will fire only when the visitor tries to leave the landing page. Use this when you do not want it to trigger if the user is simply going back to another page within your site.

Example: A user comes from Google Search to Product A page (= landing page), then moves to Product B page. If they use the browser back button to return to Product A page, the trigger will not fire. It will only fire when they try to go back from Product A page to Google Search.

Time on site trigger

You can set how long the visitor must stay on the page before the display appears. The display will be shown after the specified amount of time has passed.

Idle on site trigger

You can set how long the visitor must remain inactive on the page before the display appears. If the visitor does not interact with the page for the specified number of seconds, the display will be shown.

The following actions will reset the inactivity timer:

- Mouse movement

- Keyboard input

- Scrolling

- Clicking

Note: Switching to another tab or minimizing the browser does not reset the timer. The inactivity count continues even when the tab is in the background.

Scroll depth trigger

You can trigger a display based on how far the user has scrolled down the page.

(Plus plan and above) When the user scrolls up

This trigger fires when the user scrolls upward on the page. It is mainly intended for cases where a user on a mobile browser scrolls up to reveal the address bar.

(Plus plan and above) When returning to the site tab

This trigger shows the display when the user returns to your site's tab from another tab. There are two options: Trigger multiple times per page view or Trigger only once per page view. Please note that if you choose Trigger multiple times per page view, the display will appear every time the user returns to the tab, regardless of your redisplay settings.

(Shopify only) When a product is added to the cart

This trigger fires when the Add to Cart button is clicked on a product page or similar page.

However, for stores that automatically redirect to the cart page at that moment, that behavior cannot be overridden.

Custom trigger

In the Rules tab of the display, click Get trigger code to obtain the code. If you have JavaScript knowledge, you can configure more flexible display timing. For more details about custom triggers, please also refer to the URL below.

Using custom triggers

Related articles

Did this answer your question?