Web placement
A placement is web content that a journey shows to a user right on your website: as a popup over the page or as an inline block inside it. Add the Web Placement element to a journey to show web content to the users who reach this step, the next time they open a page of your site or right after an event, such as adding an item to the cart.
Unlike a web popup campaign, which targets every visitor that matches its rules, a placement is personal: only the users who reach this step see it, and it is shown only within the lifetime you set.
Requirements
Anchor link to- The journey’s application has the web platform configured.
- Your website is prepared for placements.
Prepare your website
Anchor link to- Use Web SDK 3.108.1 or later.
- When a visitor signs in, call
setUserIdwith the same user ID the user has in Pushwoosh. Placements are delivered by user ID: withoutsetUserId, the site gets only the placements queued for this browser itself, not those of the signed-in user. - For inline placements, add the elements the blocks go into, for example
<div id="cart-slot"></div>.
Add the element
Anchor link toDrag the Web Placement element onto the canvas from Channels.

Configure the placement
Anchor link toClick the element to open its settings and set the following.
Choose the content
Anchor link toIn Web pop-up content, select the web content to show.
To show products from your catalog in the placement, add a Products block to the content.
Choose popup or inline block
Anchor link toChoose whether the content opens over the page or sits inside the page itself.
| Popup | Inline | |
|---|---|---|
| Where it appears | Over the page. | Inside an element of your page, for example a free-shipping banner in the cart. |
| How long it is shown | Once. | On every page that has the element, until its lifetime ends, the user closes it, or the hide event happens. |
For Inline, also set:
- CSS selector of the element: the element the block goes into, for example
#cart-slot. Up to 255 characters. The element must already be on your site. - Width: the CSS width of the block, for example
100%or320px. Leave it empty to keep the element’s own width.

Set the priority
Anchor link toPriority decides which placement the user sees when several placements target the same page element or several popups are due at once: the one with the highest priority. On a tie, the newest.
In Priority, choose High, Medium (default), or Low.

Set the lifetime
Anchor link toLifetime is how long the placement waits for the user and stays on the site. If the user doesn’t visit your site within the lifetime, the placement isn’t shown.
In Lifetime, enter a number and choose minutes, hours, or days. The range is from 1 minute to 7 days, and the default is 1 hour.

Limit popup shows per day
Anchor link toThe same user can reach this step several times, for example when they re-enter the journey or pass a Loop. To limit how often they see the popup, set a daily limit.
In Show at most, times a day, enter a number from 0 to 100. 0 means no limit. The limit counts popups from this Web Placement element. Inline blocks don’t have it.

Choose whether users can close an inline block
Anchor link toBy default, a visitor can close an inline block with the ✕ button or with a button of the content that has the Close the popup action, for example Keep shopping.
To keep an inline block on the page, turn off The user can close it. The block then has no ✕ and doesn’t show the content’s Close the popup buttons. A popup can always be closed, whatever this setting is.

Choose when to show the placement
Anchor link toIn Show, choose:
- On the next page view: the placement appears as soon as the user opens any page of your site.
- On event: the placement waits for the event you select and appears right after the user triggers it. Optionally, click Add condition to filter the event by its attributes.

Hide the placement after an event
Anchor link toTo take the placement off the site when the user does something, for example places an order, turn on Hide after an event and select the event. The placement is removed when the event happens, whether or not it was shown.

Placements of a user are also removed when the user leaves the journey or the journey is stopped.
Preview on a test device
Anchor link toTo see how the placement looks on your site before you launch the journey, show it on a test device:
- In Preview, select a test device of the application. The device must be a browser with your website open.
- Click Show on test device.
- On that device, open or reload a page of your site.
The placement appears on that page and stays for 1 hour, whatever you chose in Show.
The preview uses the settings you have in the form right now, so you can check it before you save the journey. It isn’t counted in the journey statistics.
React to shows, clicks, and closes
Anchor link toWhat visitors do with a placement shows whether it worked. For example, you can send a follow-up to users who ignored a free-shipping offer, or count the users who clicked it. For this, a placement reports three events: it was shown, clicked, or closed.
Placement events
Anchor link toA placement sends three events for the user:
| Event | Sent when |
|---|---|
PW_WebPlacementShow | The placement is shown. An inline block counts as shown when it scrolls into view. |
PW_WebPlacementClick | The user clicks a link or button in the placement, except a close button. |
PW_WebPlacementDismiss | The user closes the placement with ✕ or a Close the popup button. |
Each event has the content_code attribute with the code of the web content. Use it in conditions to tell placements apart.
Use the events
Anchor link toUse the placement events to send follow-up messages depending on what the user did, and to measure results.
Branch the journey
Anchor link toAdd a Wait for Trigger element after Web Placement to send a follow-up depending on what the user did, for example a push to users who didn’t click the offer. The user moves on to the next element as soon as the placement is queued for them, not after they react.
Measure conversions
Anchor link toAdd a placement event or an order event as a conversion goal in the journey settings to count the users who reached it.
For a full example with a free-shipping offer, a follow-up push, and a conversion goal, see How to show a website offer with Web Placement.
Placement statistics
Anchor link toTo check how a placement performs, look at the Web Placement element on the canvas or in the element details of a running journey:
- Shown: how many times the placement was shown.
- Interactions: how many times it was clicked.