Reminder: before you start setting up web push, we recommend building the promo that the pop-up will link to first!

1. Go to the web push dashboard

2. Create a web push

Click "Create" in the top right

Reminder: you can create it now, but previewing or going live requires the plugin code to already be installed on your website. If you haven't set that up yet, see: How to install the web push code on your website

Choose the style you want to set up

3. Message settings

Once created, you'll enter the editing screen and see the message settings window

Set the message name
This name only shows up in the dashboard list, to help you identify and manage it
Choose a message type (pick one of three)
- Promo
  Action: clicking the pop-up redirects to a designated promo
  Choose a promo you've already created, or enter the promo ID directly to find it quickly. Once confirmed, click "OK" to finish the setup.
- Send eligibility code
  Action: clicking the pop-up redirects to a designated promo (participation is restricted to only those who saw this pop-up)
  
  Choose an eligibility-code promo you've already created, or enter the promo ID directly to find it quickly. Once confirmed, click "OK" to finish the setup.

[Additional info]

What is an eligibility-code promo?

Turn on the eligibility code feature under promo entry eligibility settings to restrict who can participate — only people who have received a code can join. Eligibility codes can be generated and sent through: "manually generate a batch of codes and send them yourself," "send via marketing promotion," or "generate a QR code via the in-person promo assistant tool for customers to scan"

Webpage
Action: clicking the pop-up redirects to a designated URL (any URL)
Set the URL you want visitors to go to — for example, a promotion page, a specific article, an account signup page, etc. Once confirmed, click "OK" to finish the setup.

4. Getting to know the web push editor

1. Web push info

The web push name (editable), online status, and schedule display (for schedule settings, see the "Settings" section below)

2. Plugin content

["Icon"-type plugin]

	Replace image	Supports two upload methods: Upload an image file directly Upload by entering an image URL Image format: width and height > 300px, any aspect ratio, no larger than 3MB, PNG file
	Alt text	If a visitor can't see the image, the content in "Alt text" will display instead. We recommend a call-to-action phrase, like: Click to join, Enter the draw now, etc.
	Resize	You can directly adjust the display size of the image. (Just adjust the width — height adjusts automatically) What size should I use? We recommend basing it on mobile — for a typical 640px screen width, think about what proportion of the screen you want this plugin to take up. If it's 1/6, aim for around 100px

3. Style

In the style settings, you can adjust the plugin's display style

1. Close button

Sets the color of the 🅧 close button in the top right of the plugin object

Tip: if you don't want a close button, you can set it to transparent

2. Background

Sets the image background color

If you upload an image with irregular edges and want to add a background color, you can set that here. Example:

3. Rounded corners

You can crop the corners of the image you uploaded

4. Display position

Where this plugin object appears on the screen

5. Spacing

After choosing a display position, you can use spacing to nudge the object further

6. Animation effect

You can set the animation effect to "None" or "Zoom"

4. Settings

In Settings, you can adjust the conditions for this plugin, such as trigger timing, click behavior, scheduling, and more

Setting	Description	Options and details
Message type	Change the message type or adjust its settings (same message type you chose during initial setup — you can adjust it again here)	Once you choose one of the three types, you can set its corresponding content. For details, see the message type explanation above
Click behavior	Sets what happens when a visitor clicks the plugin object after seeing it	Open a pop-up window Without leaving the current page, this opens a small window that shows the target URL/promo page inside it (visitors can browse/participate directly in the small window). After closing it, they'll stay on the page where they saw the plugin object. Open in a new tab Opens the target URL/promo page in a new browser tab. Open in the same page Redirects the current page directly to the target URL/promo page (replaces the current page)
Click delay	Delays how soon the plugin object can be clicked — for example, a visitor sees the plugin object as soon as they land on the page, but can't click it until 15 seconds have passed.
Scheduling	Sets when this plugin object should start running (its live schedule on your site)
Message display location	Specifies which webpage URLs this plugin object should appear on	All pages Any webpage that has the plugin code installed. If you need it to appear site-wide, we recommend choosing this option. You can still exclude certain specific pages, such as the order lookup or checkout page URLs Setting keywords: you can set a full URL, or set certain keywords within the URL Specific pages Shows the plugin object only on specific pages — for example, if you only want a spin-wheel plugin to appear on a promotion landing page, or a Q&A plugin to appear only on certain article pages, we recommend choosing this option. You can still exclude certain specific pages, such as the order lookup or checkout page URLs Setting keywords: you can set a full URL, or set certain keywords within the URL Specified task-page visitors (for use with the Multi Challenge module) Only visitors who navigated to the specified URL from a designated task card in a Multi Challenge promo (requires pairing with the Multi Challenge – Custom Click Behavior setting) can see this plugin object. With this option, you can directly choose which Multi Challenge promo to bind to, and which task within it. The system will automatically pull in the promo URL set for that task as the destination this plugin links to when clicked. [Learn more about Multi Challenge] [Example scenario] Say you have a Multi Challenge promo for new members, and one of the tasks is to read an onboarding article on your site for over 30 seconds. Since the article itself is publicly accessible, you don't want everyone who visits that article page to see this plugin object and claim the reward, since they might not actually be one of your "new members." For this kind of scenario, here's how you could set it up: In the Multi Challenge task, set up a task like, for example, Q&A Classroom (just an example — you can choose a different module), and set the entry eligibility to require an eligibility code. In that task's Custom Click Behavior setting, set it to the onboarding article's URL. Go to the web push dashboard and add a message For the message type, choose Send eligibility code, and select the promo bound to that Multi Challenge task (Q&A Classroom). Set the click delay to 30 seconds In the message display location setting, choose "Specified task-page visitors" and select that Multi Challenge promo and the same task. This way, new members coming from the Multi Challenge flow must stay on the article page for more than 30 seconds before they can click, and only visitors who arrived via this specific path will see this plugin object and be able to join the Q&A Classroom
Trigger timing	When the plugin object appears.	On page load The plugin object starts showing as soon as the page finishes loading. After staying on the page for X seconds After the page finishes loading, the plugin object starts showing X seconds later
Send frequency	How often a visitor will see the plugin object. Visit counts are tracked using browser cookies.	Every visit Once a day Only once, ever

5. Preview the plugin

There are two ways to preview it

Preview inside the editor
While you're editing, the editor itself provides a simulator preview, and you can switch between mobile and desktop views.
Preview on your actual website
Click the "Preview" button, then enter your website URL (e.g., your homepage URL). After entering it, click the preview button to confirm — it will automatically open the URL you set and show the plugin object as currently configured, so you can test clicking it.

Additional note: this preview mode only shows the configured plugin on a special, system-generated URL — it does not mean the push is officially live on your site. You can copy this URL to share with colleagues so they can preview it too.

6. Go live

Once testing looks good, click the "Go Live" button to activate the web push.

If you've set a schedule, it will start displaying according to that schedule once live.

How to Set Up a Web Push Pop-up