Skip to content

Web popup content

Web popup content is the visual layout visitors see when a Web popup appears on your website. Build it under Content, then attach it to a Web popup campaign.

Create Web popup content

Anchor link to
  1. Go to ContentWeb popup content.
  2. Click Create web popup content.
  3. Pick a starting template from the gallery. Use the category dropdown in the top right to filter by use case (for example Promotions & offers or Gaming & marketplaces), or leave it on All templates.
Web popup template gallery with a category filter, showing modal, image, bottom bar, side panel, and multi-page product tour starting templates with real illustrations
  1. Once you’ve picked a template, customize the popup in the editor.

Name the popup

Anchor link to

Click the popup name in the top bar to edit it. The name identifies this content inside Pushwoosh, in the content list and the campaign wizard. Website visitors do not see it.

Edit popup settings

Anchor link to

Adjust the popup’s appearance and position in the settings panel on the left of the canvas:

If the layout includes one or more images, each gets its own block at the top of the panel with a preview and controls.

Click Change image to pick a file from your project’s Media store.

Popup settings section with empty image preview and Change image button in the Web popup editor

Below the preview:

  • Fit: how the image fills its frame: Natural, Cover, or Contain. Not shown for a background image, which always covers its area.
  • Blur: soften the image, from 0 to 20 px.
  • Dim: background images only. Adds a dark scrim over the photo so text placed on top of it stays readable, from 0 to 100%.

Some layouts also add a Layout section with image placement settings:

  • Image width: share of the popup width, as a percentage.
  • Image position: Left or Right, for layouts with an image beside the text.

The Layout section only appears when the current layout has settings like these. On a bottom bar layout, it offers Buttons width instead of image controls.

Anchor link to

In the Popup section:

  • Width, Height (empty = auto): leave both empty for a popup that sizes itself to its content, or set a fixed size in pixels. In a popup with multiple pages, each page has its own size.
  • Corner radius, Shadow: the popup’s corner rounding and drop shadow.
  • Animation: how the popup appears: None, Fade, or Slide.
Popup section in the settings panel with width, height, corner radius, shadow, and animation controls

Click Colors to expand the popup’s color palette:

  • Background, Accent (buttons): the popup background and the accent color applied to buttons.
  • Text, Secondary text: the color of body text and of secondary text such as captions and eyebrows.
  • Text over image: only shown for layouts with text over a background image. Sets the color used for that text.
Colors section expanded, showing Background, Accent, Text, Secondary text, and Text over image pickers

Placement and overlay

Anchor link to

In the PLACEMENT section:

  • Position: pick where the popup anchors on the page using the 3×3 grid.
  • Edge offset: set the distance in pixels from the selected edge.

In the OVERLAY section:

  • Dim the page behind: turn on to darken the rest of the page while the popup is shown.
  • Color, Opacity: set the overlay color and opacity from 0 to 1.
Web popup settings panel with POPUP, PLACEMENT, and OVERLAY sections including placement grid and overlay controls

Click any text block on the popup to edit it inline. A toolbar appears above it:

  • Apply bold, italic, or underline formatting.
  • Add or remove a link.
  • Set left, center, or right alignment.
  • Choose a text style: Icon, Eyebrow, Heading 1–3, Body, or Caption.
Selected text on the Web popup canvas with the inline editing toolbar showing formatting, alignment, link, and style controls

Edit buttons

Anchor link to

Click a button to open its toolbar:

  • Choose the button style: Primary or Secondary.
  • Choose what the button does:
    • Open a link: enter the target URL.
    • Close the popup.
    • Go to page: pick another page of the popup to switch to. This option appears once the popup has more than one page. See Work with multiple pages.
Selected button on the Web popup canvas with the button editing toolbar open

Add a subscription form

Anchor link to

Add a Subscription form block to collect email signups and other fields directly in the popup. Learn more about subscription forms.

Add the block

Anchor link to
  1. Select a text block, button, or other element on the canvas.
  2. Click Add on its toolbar.
  3. Choose Subscription form. The block appears right away with a default Email field and Subscribe button.
Add menu on the element toolbar with Text, Button, and Subscription form options

Choose a form source

Anchor link to

Click the subscription form block to open the FORM toolbar. Its first dropdown links the block to a subscription form in your project. You can create a new form or pick one that already exists:

OptionWhen to use
New form — created on save (default)Fastest start: Pushwoosh creates the form for you when you save the popup, named “popup name — web popup”.
+ Create new form…You want to name the form and set it up before you save the popup. Opens a New subscription form dialog — enter a Name, then set its Fields, Submit text, and Privacy the same way as below, and click Create.
An existing form from the dropdownReuse a form that already has subscribers or double opt-in configured.
FORM dropdown on a subscription form block showing New form created on save, existing forms, and Create new form option

Set fields and submit behavior

Anchor link to
  1. Set the Submit button style in the FORM toolbar:
    • Primary: filled button in the popup Accent color. Best when Subscribe is the main action on the page.
    • Secondary: outlined button with a border and accent-colored label. Best when the popup already has a primary button or you want a lighter look.
  2. Turn on Privacy to add a privacy-consent line under the form, then enter your privacy policy URL in the field that appears.
Privacy checkbox enabled in the FORM toolbar with a privacy policy URL field
  1. Click Fields… to open a popover where you can keep Email (always required) and add First name, Last name, Phone, or Custom, and set the Success and Confirm email texts shown after a visitor submits.
Fields popover with Email, First name, and Phone fields, add Last name and Custom buttons, and After submit Success and Confirm email texts

Work with multiple pages

Anchor link to

A Web popup can have more than one page, for example to guide visitors through a short multi-step offer.

Add a page

Anchor link to

Click + Add page to open the add-page menu:

  • Duplicate current page: copies the active page, including any edits you’ve made, as a new page.
  • Pick one of the single-page layouts to add a fresh page with that layout’s demo content. The new page is independent of the others, so it can use a different layout.
Web popup editor page tabs with multiple pages, start-page marker, and Add page

Each tab is one page. Click a tab to switch to it.

Set the start page

Anchor link to

The tab marked with ★ is the start page, the page visitors see first. To change it, open another tab and click ☆ on that tab.

Page tabs showing start-page star marker on one tab and delete control on the active tab

Delete a page

Anchor link to

On the active tab, click . A confirmation dialog opens. Click Delete to remove the page. This can’t be undone.

Save the content

Anchor link to

Review the content, images, and button actions. When you are finished, click Save in the top bar.

Use the content in a campaign

Anchor link to

After you save, the content appears in ContentWeb popup content. Open it from the list to keep editing.

To show it on the site, go to CampaignsWeb popups, create or edit a campaign, and pick this content in the Content step.

Then configure the audience, display settings, frequency, and launch options. For the full flow, see Create Web popup campaigns.