Need help? You’ve come to the right place

What’s New Getting Started Building Integrating Publishing

Publish pop-ups to WordPress

Last Updated

While you can publish pop-ups to any webpage that accepts JavaScript and HTML, if you run your site through WordPress you can use our plugin to easily publish pop-ups.


The fine print

  • This only works with our standalone pop-ups—not pop-ups that are attached to a page. To learn more, check out Creating a pop-up.
  • Some pop-up publishing methods below require our Leadpages WordPress plugin. If you haven’t installed the plugin yet (or are using a version below 2.1) you can follow our installation instructions here.
  • For an overview of pop-ups (and the different types you can use), see How pop-ups work.

Button, text link, and image pop-ups

Copy+Paste method

All standalone pop-ups can be published via the HTML code produced in the Publishing Options of the pop-up, accessible either in the builder or from the Conversion Tools > Pop-Ups listing under the actions menu more. This method does not require our WordPress plugin. Learn more on where to find your pop-up code.

WordPress 5.0

WordPress 5.0 is WordPress' newest editor, which gives users the ability to edit their posts by using blocks to arrange content.

Once you've got your pop-up code, when editing your post or page (or creating a new one) in WordPress 5.0, add a Custom HTML block where you'd like the pop-up to show up on your page (if it's a timed popup or exit intent pop-up, it doesn't matter where you place the block on your page).


Once that block has been added to your WordPress page or post, paste your pop-up code into the HTML code block.


WordPress Classic Editor

WordPress Classic Editor is WordPress' legacy editor and will be supported by them until 2021. If you're running a version of WordPress prior to 5.0, you're likely using the Classic Editor.

Once you've got your pop-up code, while editing your post or page (or creating a new one) in WordPress, be sure to switch over to the Text editor, which will allow you to paste in HTML. Then, paste in the code for your pop-up where you want it to appear in your post, as shown below.

Adding pop-ups to WordPress widgets

In order to add a pop-up to a WordPress widget, you'll want to have your pop-up publishing code handy, either as a plain text link, button, or image pop-up. Learn more here on how to access that code here.

Step-by-step adding a pop-up to a widget

  1. Copy your entire pop-up publishing code, then navigate to Widgets under Appearance on the left-hand sidebar of your WordPress editor.
  2. Select a Text widget, then make sure you're in the Text tab of the widget editor.
  3. Paste the pop-up code and Save your widget.wordpress_widgets.jpg

Leadpages Connector Plugin (Legacy) - Timed and exit pop-ups

NOTE: This section is relevant only for users using our legacy WordPress-Leadpages plugin (v2.3.13). It is not currently possible to pull pop-ups through our new plugin (v1.1.0). If you are using our newest plugin and looking to publish timed and exit pop-ups, we recommend injecting your pop-up codes on your WordPress pages through the Head, Footer and Post Injections plugin. If you’d like to use the older plugin, you can download it here.

Our plugin allows you to publish timed or exit pop-ups globally to your site—so all your pages can instantly call visitors to action. You can also publish timed and exit pop-ups to individual pages. Follow the steps below to learn how.

Configuring your publishing options

To publish a timed pop-up or an exit pop-up to WordPress, you’ll first need to configure and save those settings in Leadpages. Click Publish Options from your pop-up's action menu, then choose your desired options from the pop-up, as seen below.

NOTE: The publishing options you choose for your pop-up will apply to each page URL where you publish it. Therefore, if a timed pop-up is published globally to every page of your site, a pop-up that has launched on one page would not affect it launching on another.

Global timed and exit pop-ups

Here’s how you can publish timed/exit pop-ups globally to your WordPress site:

  1. Hover over Leadpages in your WordPress Dashboard’s sidebar, then click Pop-Ups.
  2. Select “Paste Drag & Drop Pop-Up” option, and paste in your pop-up's code as described in our article: Publishing your pop-ups.
  3. Decide if you want your pop-up to appear on all pages, posts only, or pages only. Note that only one global timed or exit pop-up can be active at a time.
  4. Click Save to finish.

To exclude a global pop-up from a specific page, open the page's editor in WordPress, click on the Page Specific Pop-up drop-down, then select None under whichever global pop-up you would not like to show on that page.

If you want a different pop-up to show up (or none at all) on a particular page, you can use the copy + paste method.

WARNING: When you make changes to your pop-up's publishing options within Leadpages, updates will automatically be reflected in WordPress when using the plugin. To publish different styles of the same pop-up (e.g. as a button on one page and text link on another) we recommend duplicating the pop-up and adjusting publishing styles independently.

Frequently asked questions

Why does my pop-up appear in a new window at a Leadpages URL on mobile?

Pop-ups on mobile automatically open in a new page in order to support the widest variety of mobile devices possible—so you don’t miss out on opt-ins from visitors using older devices.

Why doesn’t my timed or exit pop-up show up on mobile?

Exit and timed popups are disabled on mobile. One reason is to ensure your site’s SEO isn’t negatively affected by pop-ups—Google and other search engines may boost sites’ search rankings that avoid using timed popups on mobile. Also, most internet browsers block popups on mobile.

How can I add a timed or exit pop-up to a landing page?

Since landing pages aren’t quite the same as normal WordPress pages, the pop-up plugin does not interact with them. Instead, you can add your exit or timed pop-up HTML code to your page’s tracking code head section. See our guide here for instructions.

Need more help?

You can always get in touch with our support team—just click Support in your Leadpages navigation menu, or submit a ticket ↗

Was this article helpful?
Powered by Zendesk