Skip to main content

Back button trigger not working — Troubleshooting

Explains browser-specific limitations of the back button trigger and how to troubleshoot cases where it fails to fire.

If the back button trigger is not firing, follow the steps below to identify the cause.

Quick checks

  • Has the user tapped or clicked anywhere on the page at least once?

  • Is the user browsing in Safari's private mode?

Step-by-step diagnosis

The page requires a tap before the trigger can fire

Due to browser restrictions, back button detection requires at least one tap (click) on the page. Scrolling alone is not sufficient.

Exceptions — no tap required:

  • When the page is opened in a new tab on iPhone Safari

  • When the page is opened in an in-app browser on iPhone apps such as LINE or Instagram

The tap does not need to be on a button or link — tapping any empty area on the page is sufficient.

Workaround: Show another Promolayer popup that the user must close first. The close action counts as a tap.

Safari private browsing

The back button trigger does not work in Safari's private browsing mode.

After the trigger fires

After the trigger fires and a display appears, reloading the same tab will not trigger it again. Opening the page in a new tab or window resets the state and allows it to trigger again.

Still not working?

Contact us via live chat. Please include your browser, device, and a description of the steps you took.

Did this answer your question?