Configure popup display rules

Control where, when, and how often a Revup popup appears.

Choose how a popup opens

Control where and when a Revup popup appears automatically, or connect it to a custom button or link.

Before you start

The matching Revup promotion block must be present on the page and configured as Popup. For Shopify, paste the promotion token from Revup into the theme block before adding a custom trigger.

The examples below use promotion ID 21. Replace it with the numeric ID at the beginning of your promotion token. For example, the promotion ID in 21-a1b2c3d is 21.

Configure automatic display rules

Open Share → Embed on site → Popup and the Popup Display Rules editor. Purchase Sweepstakes exposes its Shopify popup setup through Install.

Setting	Choices and limits
Trigger	Immediately, After a delay, After scrolling, Exit intent, or Manual only. The default is After a delay.
Delay seconds	0–86,400 seconds; default 5.
Scroll depth	1–100%; default 50.
Frequency	Every visit, Once per visitor, or Once per session. The default is Once per visitor.
Frequency days	1–365 days for the visitor interval; default 7. Once per visitor does not mean never again.
Stop after entry	On by default; suppresses further automatic display after entry is recorded in that browser.
Show floating reopen button after close	On by default; lets the visitor reopen the popup.
URL targeting	All pages, or Only URLs containing your listed text.
Include URL rules / Exclude URL rules	List the URL text to match. The include mode needs at least one rule.

The popup still needs to be installed on the page. These display preferences are not participant eligibility or security restrictions. Browser storage and a new browser/device can affect whether a visitor is recognized. There is no separate device selector in this editor.

Open a popup programmatically

Dispatch this event after the Revup popup code has loaded:

window.dispatchEvent(new CustomEvent('revup_open_popup', {  detail: { promotion_id: '21' }}));

Running this command directly in a page script opens the popup as soon as that script runs. Use a click listener when a visitor should open it from a button or link instead.

Connect a Shopify button or link

Add an ID to the Shopify link or button that should open the popup, then listen for clicks on that ID:

<a href="#" id="open-revup-popup">  Enter without purchase</a><p data-fb-blank-line-spacer></p><script>document.addEventListener('click', function (event) {  const trigger = event.target.closest('#open-revup-popup');<p data-fb-blank-line-spacer></p>  if (!trigger) return;<p data-fb-blank-line-spacer></p>  event.preventDefault();<p data-fb-blank-line-spacer></p>  window.dispatchEvent(new CustomEvent('revup_open_popup', {    detail: { promotion_id: '21' }  }));});</script>

You can change open-revup-popup to another unique ID as long as the value in the HTML and the selector in closest() remain identical.

Test the popup

Test matching and nonmatching pages, new and returning sessions, mobile screens, keyboard close behavior, and the promotion lifecycle. Confirm the popup stops appearing after completion or at the intended frequency.

Avoid conflicting with cookie notices, checkout, accessibility tools, or another modal.