Blocks

Reference for every block you can add from the Elements tab in web content and in a web form.

How to configure blocks

1. Open the Elements tab on the right.

2. Drag a tile onto the popup, or click it to add it to the page.
   • A click inserts the block below the selection on the canvas.
   • If nothing is selected, the block goes at the end of the page’s first section.
3. Select a block on the popup to open the Settings tab (next to Elements). Adding a block from Elements opens Settings right away.

To move a block anywhere on the popup, including into another section, select it and drag the handle that appears to its left into any gap.

In Settings you can:

• Configure that block’s own options
• Move it up or down within its section with POSITION (up and down arrows)
• Delete it with the delete icon

Note

When a section of the popup has no elements yet, it shows its own + Text and + Button controls in place. To add an Icon, Countdown, Topic picker, or Rating there instead:

1. Add an element using the + Text or + Button control.
2. Select it.
3. Add the block from the Elements tab. It lands in the same section, below your selection.

Common blocks

The Text, Button, and Icon blocks are available in both web content and web forms.

Text

Click any text or button label 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.

To change the text style:

1. Select the text and open the Settings tab on the right.

2. Choose a style:

   • Icon: a text style, not the Icon block.
   • Eyebrow
   • Heading 1–3
   • Body
   • Caption
   

Button

Click a button to select it, then open the Settings tab on the right:

• Button style: Primary or Secondary.
• Action:
  • Open a link: enter the Link URL. New tab is on by default. Clear the checkbox to open the link in the same tab instead.
  • Close the popup.
  • Subscribe: request web push permission and subscribe the visitor. Only web content offers this action. A button in a web form has the other three. This is not the email Subscription form block. A granted request closes the popup. A denied one disables the button, because the browser won’t prompt twice.
  • Go to page: pick another page of the popup to switch to. This option appears once the popup has more than one page. See Multiple pages.

Use POSITION to move the button up or down, or the delete icon to remove it.

Icon

Add an Icon block to drop a small pictogram (for example a percent sign for a sale, or a gift for a giveaway) next to your text. This is the Icon block, not the Icon text style under Text.

1. Open the Elements tab on the right.
2. Click Icon.
3. Set the options in the Settings tab:

• Icon: pick from a fixed set of 20 icons (bell, gift, cart, chart, lock, calendar, check, star, clock, tag, mail, phone, download, play, shield, sparkle, percent, truck, ticket, user). Custom icon uploads aren’t supported.
• Size: 24, 32, or 48 px.
• Accent: on by default, so the icon matches the popup’s accent color. Turn it off to pick a custom color.

Web content blocks

The Countdown, Topic picker, and Rating blocks are only in web content. A web form doesn’t have them. Some templates in the Web content template gallery already include these blocks. You can’t add a Subscription form block to new content, but web content that already has one can still edit it. See Subscription form.

Countdown

Add a Countdown block to build urgency with a deadline that ticks down live on the popup.

1. Open the Elements tab on the right.
2. Click Countdown.
3. Set the options in the Settings tab:

• Deadline: the date and time the countdown reaches zero.
• Time zone: the zone the deadline is read in, not the visitor’s own time zone. Defaults to your browser’s time zone; pick UTC from the list to read the deadline literally instead.
• Language: the language of the unit labels (days, hours, and so on). Leave it on English (default) or pick from 14 other languages.
• Labels: turn on to show unit labels next to the numbers.
• When the deadline passes:
  • Show zeros: the countdown keeps showing 00:00:00.
  • Do not show the popup: the whole popup is skipped once the deadline is in the past. Pushwoosh checks the deadline right before the popup would appear. A popup skipped this way doesn’t count against Once per visitor frequency.
  • Go to page: jump to another page of the popup when the deadline passes. Only offered once the popup has more than one page. Pick the target page from the dropdown that appears. See Multiple pages.

Topic picker

Add a Topic picker block to let visitors self-select interests as checkboxes or chips. Their picks are written to a tag on their device.

1. Open the Elements tab on the right.
2. Click Topic picker. The block appears with two placeholder options. Its settings open in the Settings tab.

3. In List tag the choice is written to, pick an existing List-type tag, or choose Create a list tag to make one without leaving the editor. Until you pick a tag, the block does not write anything.

4. Set Control to Checkboxes or Chips.

5. Set Minimum picks and Maximum picks. 0 on either end means no limit on that side (0 = any in the field labels). At least one pick is always required to submit, even when Minimum is 0. Picking past the maximum, or trying to submit under the minimum, shows an inline message next to the block instead of sending anything.

   

6. Under Options and copy, edit each option’s label (what the visitor reads) and Tag value (what’s written to the tag). If you leave Tag value empty, Pushwoosh writes the option’s internal ID instead (option-1, option-2, and so on). Use + Option to add another row, up to 12 options total.

   

7. Set the Button label (default Save) and the Message after sending (default Thanks! Your choice is saved.).

   

Picks only add, they never remove

A visitor’s picks are appended to the tag. Submitting the block again adds more values. It never clears previous ones. A popup can’t let a visitor un-pick a topic they chose before. That needs a different surface, like a preference page backed by the same tag.

Rating

Add a Rating block to collect a quick score (NPS, stars, or thumbs) as a custom event.

1. Open the Elements tab on the right.
2. Click Rating. The block appears with no event set. Its settings open in the Settings tab.

3. Set Scale to NPS 0–10, Stars (1 to 5), or Thumbs (up or down). Across all three, a higher score means a more positive rating. Thumbs sends 1 for a thumbs-up and 0 for a thumbs-down.
4. Set When the score is sent to On tap (sends when the visitor picks a value) or With a button (waits for a submit click).
5. In Event the score is sent as, pick an event from your project, or choose Create an event to define a new one without leaving the popup. The score is stored as that event (score, scale, and slotKey attributes). Use it in segments or Customer Journeys like any other event. Until you pick an event, the block does not send anything.
6. Optionally fill Left label and Right label at the two ends of the scale.
7. If When the score is sent is With a button, set the Button label (default Send rating).

Creating an event here is permanent

• An event you create from this menu is a real event on your project, not a draft. Deleting it later means going to your project’s event list, not just changing the popup.
• If an event bound to the block is later renamed or deleted elsewhere, or was typed into this field before it became a picker, the picker shows Missing: <event name>. It does not silently drop or swap the event. Pick a different event to fix the binding.

Subscription form

The Subscription form block links the popup to a subscription form from Audience → Subscription forms.

• The block isn’t offered in Elements, so you can edit it only in web content that already has it.
• To collect emails and other fields in new content, create a web form instead.
• For web push permission, use a button with the Subscribe action.

To edit the block, select it on the popup. Its settings open in the Settings tab.

Choose a form source

With the block selected, the Settings tab shows a Subscription form dropdown that links the block to a subscription form in your project. You can create a new form or pick one that already exists:

Option	When 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, set Fields, Submit text, and Privacy, then click Create.
An existing form from the dropdown	Reuse a form that already has subscribers or double opt-in configured.

Important

If you pick an existing form from the dropdown, saving this popup updates that subscription form for the whole project. The fields, submit button text, and success messages you set in this block replace what that form had before. That includes the form embedded on your website and the form in Audience → Subscription forms.

Other Web popups that use the same form are not updated. Each popup keeps its own copy of the block’s fields and texts until you reopen that popup and save it again.

Set fields and submit behavior

Still in the Settings tab:

1. Set the Submit button style:
   • 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.

3. Under Fields, keep Email (always required) and add First name, Last name, Phone, or Custom.
   • For a Custom field, pick the tag its value submits to from the Pick a tag… dropdown, or choose Create a tag to make a new string tag without leaving the editor.
   • Set the Success and Confirm email texts shown after a visitor submits.

Web form blocks

The Email input, Tag input, Consent, and Submit blocks are only in web forms. See Web forms for how a form works and how to save it.

Note

The texts of a block, including its error messages, are shown to visitors exactly as you enter them. Write them in the language of your site.

Email input

The field where the visitor enters an email address. It is always required.

1. Set Label and Placeholder: the field caption and the hint inside the empty field. Defaults are Email and you@example.com.

2. Edit Invalid email text, shown when the address is malformed or Pushwoosh rejects it. Default is Enter a valid email.

3. Edit Required field text, shown when the field is empty. Default is Required.

   

A form with an Email input also needs a Consent block with a privacy policy URL.

Tag input

A text field whose answer is saved to a tag on the visitor’s device. The form editor can’t create tags, so create the tag in Audience → Tags before you add the field.

1. In Tag, choose an existing tag. The list shows String tags only, and you can type to search. Each tag can be used in one field of the form.

2. Set Label and Placeholder.

3. Select Required if the visitor must fill the field, and edit Required field text if needed.

   

A form can’t write tags whose names start with PW_FF_.

Consent

A checkbox with a link to your privacy policy. When the form has several consent checkboxes, the visitor must select all of them to submit.

1. Set Checkbox text and Link text: the text before the link and the link itself. Defaults are I agree to the and privacy policy.

2. In Privacy policy URL, enter the page the link opens: a full https:// address or a path on your site that starts with /.

   

3. Edit Consent required text, shown when the visitor submits without selecting the checkbox. Default is Please accept the privacy policy.

Submit

The button that sends the form.

1. In Button style, choose Primary or Secondary.

2. Edit Button text. Default is Submit.

3. Edit Submit error text, shown when the submission fails, for example because of a network error. The visitor can submit again. Default is Something went wrong. Please try again.