Create Web popup campaigns

A web campaign places the web content you’ve created onto your website and controls when it appears and who sees it. A campaign shows its content in one of two ways: as a Popup or as an Inline block.

Start a new campaign

1. Go to Campaigns → Web campaigns.

2. Click Create campaign and choose the type:

   • Popup: an overlay on top of the page.
   • Inline: a block inside an element of your page, for example in a sidebar or under an article.

   You can’t change the type later.

   

Web SDK version for Inline campaigns

Ask your developer to check the Web SDK version on your site. Inline campaigns need 3.97.0 or later, or 3.98.0 or later if the site uses the npm package. With an older SDK, an Inline campaign appears as a popup over the page instead of inside the block.

Select web content

Choose the content this campaign shows to visitors. You can pick existing content or make new content without leaving the wizard.

• Existing content: in Web content, select an item from the list. Under each name, the list shows its type: Web content for regular content or Web form for a web form.
• New content: click Create new and choose Web content or Web form. The editor opens for that content type.

To change the order of content in the dropdown, use the sort button above it and choose Last updated, A-Z, or Z-A. The dropdown is sorted A-Z until you pick another order. Pushwoosh remembers your choice and uses it in every Web popup content dropdown, in one-time messages and journeys alike.

Collect emails and answers

Select a web form to subscribe visitors to email and save their answers to tags. The same form works in Popup and Inline campaigns. Learn how to build one.

Click Next when the right content is selected.

Define audience

Select who should see the campaign.

• All users: show the campaign to everyone without filters.

• Target audience: show the campaign only to users who match a segment or custom conditions. Two sub-options appear:
  • Use existing segment: pick a saved segment from the list. To create one without leaving the wizard, click Create segment.
  • Use custom conditions: build the audience inline by adding filters by Tag, Event, Segment, or User ID.

When you’re done, click Next.

Configure display settings

Set up when, how often, and where to show this campaign.

CSS selector

This field appears for Inline campaigns only. An Inline campaign appears inside a block of your page, and the CSS selector tells Pushwoosh which block.

1. In CSS selector, enter the selector of the page element the campaign is placed into, for example #newsletter-signup. Use one simple selector: a tag, an #id, a .class, or an [attribute], without nesting.

2. Under the field, Pushwoosh shows the element to add to your page, for example <div id="newsletter-signup"></div>. Ask your developer to add it where the campaign should appear.

   

The campaign appears inside the first element on the page that matches the selector. If the page has no matching element, the campaign isn’t shown there.

With Automatically on page load, an Inline campaign appears each time a page with the matching element loads.

Show popup or Show campaign

Choose how the campaign is shown. The field is called Show popup in a Popup campaign and Show campaign in an Inline campaign.

• Automatically on page load: the campaign appears by itself on pages that match its settings.
• Only via WebSDK call: the campaign doesn’t appear by itself. Your site shows it by calling the Web SDK. The wizard shows the call with the campaign code, for example Pushwoosh.moduleRegistry.webPopups.show('CAMPAIGN_CODE'). Requires Web SDK 3.63.0 or later.

With Only via WebSDK call, the wizard hides Display delay and Show on pages, because a call from your site ignores them.

Display delay

This setting is for Popup campaigns shown Automatically on page load. Choose when the Web popup may first appear after the page loads.

• Immediately
• After 3 seconds
• After 5 seconds
• After 10 seconds

How the delay is measured

• The delay is measured from the moment the Pushwoosh SDK initializes on the page, not from when the page starts loading.
• The actual time before the Web popup appears may be slightly longer than the value you set. For example, if the SDK takes 2 seconds to load and you set a 5-second delay, the Web popup appears 7 seconds after the page starts loading.

Frequency

This setting is for Popup campaigns only. Under FREQUENCY, choose how often a visitor can see this Web popup:

• Once per visitor: the visitor sees the popup at most once in that browser, even in a new tab.

Note

Pushwoosh can recognize the same visitor only while the browser keeps the Web SDK data. If the visitor clears browser data, uses another browser, or opens the site on another device, Pushwoosh treats them as a new device, so the Web popup can appear again.

• Once per session: the visitor sees the popup once per browsing session. If they close a tab and return before the session ends, the popup does not appear again.
• Every visit: the popup appears each time the visitor loads a matching page.

Device

In Device, choose the devices the campaign appears on: All devices, Desktop, or Mobile.

Push permission

In Push permission, choose which visitors see the campaign, depending on whether they allowed web push notifications in this browser:

• All visitors: everyone, whatever their push permission. This is the default.
• Not asked yet: visitors the browser hasn’t asked for push permission yet. Use it for a prompt that invites them to subscribe.
• Subscribed: visitors who allowed push notifications.
• Blocked: visitors who blocked push notifications, for example to explain how to allow them again in the browser.
• Push not supported: visitors whose browser can’t receive web push notifications. Use it to offer another channel, such as an email form.

The Review step shows the option you chose next to the device, as Push permission: and the option name.

The visitor’s browser checks the permission when the campaign is about to show. If the visitor allows or blocks notifications on the page, campaigns that no longer match are removed, and a campaign that starts to match shows after the next page load.

Web SDK version for push permission

This setting needs Pushwoosh WebSDK 3.103.0 or later. If your site loads web campaigns with an older WebSDK core, only campaigns set to All visitors show there.

Show on pages

Choose the pages where the campaign can appear. This setting is hidden with Only via WebSDK call.

Web SDK version for page rules

Excluding pages, and the Starts with match type, both take effect only on sites running an up-to-date Pushwoosh WebSDK. WebSDK 3.104.1 and later match paths with letter case, while 3.102.0 to 3.104.0 ignore it. On WebSDK versions earlier than 3.102.0, the paths you enter also don’t match pages whose address contains spaces or letters outside the English alphabet, such as é or ñ.

All pages

Show the campaign on every page of the site. To keep it off some pages, add up to 10 exclusions:

1. Click + Add exclusion.
2. Enter the page path.
3. Choose how the path should match: Exact match or Starts with.

Specified pages

Show the campaign only on the pages you list. You can add up to 10 pages:

1. Click + Add page. To remove a row, click ×.
2. Enter the page path.
3. Choose how the path should match: Exact match or Starts with.

Click Next to continue.

Enter a page path

The path tells Pushwoosh which pages a rule covers. The same rules apply to exclusions and to specified pages.

What to enter

• Enter the path as it appears after your domain, for example /pricing or /blog/intro.
• The path can contain letters of any alphabet, digits, spaces, and the characters - _ . ~ ! $ & ' ( ) * + , ; = : @ /.
• Paths are case-sensitive, so /Pricing and /pricing are different pages.

Paths saved from October 27 to November 2, 2026

Pushwoosh saved paths entered in that period in lowercase. On WebSDK 3.104.1 and later, such a rule no longer covers pages whose path has capital letters, with Exact match and Starts with alike. Open the campaign and enter the path again in your site’s letter case.

Pasting a full address

You can also paste the full address from the browser’s address bar or an encoded path. Pushwoosh removes the domain, the query string, and the fragment, then saves the path decoded, with the letter case kept. For example:

You enter	Pushwoosh saves
https://example.com/Catalog/?sort=price	/Catalog/
/caf%C3%A9	/café

Match types

The match type decides which pages the path covers:

Match type	Pages it covers
Exact match	Only the page whose path is the same as what you enter. /pricing doesn’t cover /pricing/ or /Pricing.
Starts with	Every page whose path begins with what you enter, in the same letter case. /blog covers /blog/intro and also /blog-news, so enter /blog/ to cover only the blog section.

Review the campaign

The Review screen summarizes:

• Content: the web content attached. See Select web content. A campaign still linked to a legacy subscription form instead of web content shows that form’s name here instead.
• Audience: All users, or Target audience with the selected segment name or custom conditions.
• Display settings: device, the pages the campaign shows on (including match type and any exclusions), delay, and frequency.

Use CHANGE OPTIONS on any block to jump back and edit that part.

The Preview area shows how the content looks on a sample viewport. Use EDIT CONTENT if you need to adjust the underlying content asset.

When everything looks right, click Complete setup.

Then pick an option from the menu:

• Launch campaign… activates the campaign after you enter a campaign name and confirm. For an Inline campaign, an Embed code dialog then shows the element to add to your page. You can open it again later with Get embed code… in the campaign’s row menu.

  

• Save as draft… saves the campaign without activating it. To go live later, go to Campaigns → Web campaigns, open the three-dot menu on the draft’s row, and choose Activate campaign…. To change settings first, choose Edit campaign… in the same menu.

To search, filter, and manage campaigns from the list, see View and manage campaigns.