Whenever you want to create a popup for an online campaign on your website, you can use a ready-made tag in Tag Manager, called a popup. In this article, we’ll show you how to set it up.

Before you start
Here are some things to know before you begin working with popup tags:
- You need to have basic knowledge of HTML and CSS to design the popup, but setting it up is easy.
- The popup tag is set to be displayed for visitors who consent to
A/B testing and Personalization
, but you can change this setting. - The popup tag loads simultaneously with other tags (It’s an async tag).
- The class name for the closing button must stay as is
ppms-popup-close-button
, otherwise the button will not work.
Set up a popup tag
To set up a popup tag, follow these steps:
- Design and code your popup in HTML.
- Go to Menu > Tag Manager.
- Navigate to Tags.
- Click Add a tag.
- Name the tag and choose the following tag type: Popup.
- Click Next.
- In HTML tag code, type the code with your popup. Adjust the CSS, so that the popup fits your website’s design. The code that is already there is a basic popup container.
Note: The class name for the closing button must stay as is
ppms-popup-close-button
, otherwise the button will not work. - In Advanced tag settings, set the tag type. By default, it’s set to be displayed to visitors who consent to
A/B Testing and Personalization
, but you can change it to a different type.
- Respect opt-out and DNT is turned on by default. Leave it as is, if you want to respect visitors who set Do-Not-Track in their browsers, or visitors who opt out of tracking using our opt-out form.
- Enable document.write is turned off by default. Toggle this option, if your tag needs
document.write
. - In Flight dates, set the date and time when the tag is fired.
- In Tag triggers, click Add a trigger or Choose existing trigger to set up a trigger for your popup.
- If you’re setting up a new trigger, name the trigger.
- In Trigger type, choose a type. For example, Page scroll.
- Click Next.
- In Amount of page scrolled, set desired percentage or pixels. For example,
25%
. - In Event conditions, define conditions for the trigger. For example,
Page URL contains blog
.
Avaliable below 16.0.0
In Audiences, pick an audience for which you want to run the tag. For example, we’ve got an audienceApple product users
and we want to fire the tag only for visitors from this audience.
Tip: For more about audiences, read this article.
- In Multiplicity, set how often the tag should be fired. For example, Once in a session.
Tip: We advise you to fire the popup once per session because visitors may be overwhelmed when they see it too many times.
- When you’re done, click OK.
- Click Save for the tag.
- Test your tag in debug mode.
- When you’re happy with how the tag works, click Publish.
Track popup impressions
To start tracking popup impressions, follow these steps:
- Go to Menu > Tag Manager.
- Navigate to Tags.
- On the left, click Piwik PRO tag.
- In Piwik PRO setup, turn on Interactions with popups and content.
- After this option is turned on, the tracker will start counting popup impressions on your website. All stats will be available under Menu > Analytics > Reports > Content performance.