How to Add a Leadbox to a Leadpage: Pop-Ups Explained (2026)

To learn how to add a Leadbox to a Leadpage, it helps to know that Leadboxes are now simply called pop-ups. Leadpages has two kinds. On-page pop-ups belong to one page or site and open when a visitor clicks a button, image or text link. Standalone pop-ups are built separately, published with a snippet of code, and can open on a click, after a time delay or on exit intent on almost any website. This guide covers both, with steps for the Classic Builder, notes for the newer app, and fixes for the common problems.

How to Add a Pop-Up to a Button on Your Leadpage

Most Leadpages templates already include an on-page pop-up attached to the main button, so the first job is often editing rather than creating. These steps are for the Classic Builder.

1. Edit an existing pop-up: hover over the button and click Edit Pop-Up, or click the button and then the link icon in its settings.
2. Create a new one: drag a button, image or text widget onto the page, hover over it and choose Add Click Event, then Open a Pop-Up, then Create New.
3. Set up the form inside the pop-up: choose the integration, edit the fields and set what happens after submission. The forms guide covers each tab.
4. Name the pop-up under Settings in the left sidebar so you can tell several apart.
5. Preview the page and click the trigger to check that the pop-up opens, then update the page.

A page can hold up to 24 on-page pop-ups, and Leadpages suggests deleting unused ones because many pop-ups can affect loading. To remove one, hover over its button, click Edit Click Event, pick the pop-up and click Delete Pop-Up. Leadpages counts a pop-up as a two-step opt-in, because the form appears only after the click; a form placed straight on the page is one-step. For button styling and other click actions, see buttons, links and timers.

In the New Leadpages App

The editor's Add tab includes a Pop-up block described as pop-ups that open from your page, alongside Form and Button blocks, and the sidebar has a Pop-ups area under Create. You can also ask Piper, the AI builder, to create a pop-up. The new app's help articles do not yet give step-by-step pop-up instructions, so check the block's Settings tab for its trigger and form options.

Create a Standalone Pop-Up for Other Websites

1. Go to Conversion Tools, then Pop-Ups, and click Create New Pop-Up.
2. Name it and click Start Building. New pop-ups start with some text and a form.
3. Edit the content with widgets, and keep it short: one offer, a few fields and one button.
4. Set up the form integration, fields and follow-up action, then click Publish.
5. Choose a trigger: plain text link, button, image, time delay or exit intent. Timed pop-ups can wait for a set time or number of page views, and timed and exit pop-ups can wait a number of days before showing again.
6. Click Get Code, copy the whole snippet and paste it where the trigger should appear on your site.

The snippet has two parts: a JavaScript loader and the trigger itself. The loader only needs to appear once per page, even if that page uses several pop-ups. Timed and exit triggers are invisible, so their code can sit almost anywhere on the page. Editing the pop-up's content and clicking Update changes it everywhere it is published, but changing trigger options produces new code that you must paste again.

Put a Timed or Exit Pop-Up on a Leadpages Page

On-page pop-ups open on a click only. For a timed or exit-intent pop-up on a Leadpages page, use a standalone pop-up:

1. Publish the standalone pop-up with the time delay or exit intent trigger and copy its code.
2. Classic Builder: open the page, select the Settings tab, go to Analytics and paste the code into Head Section Tracking Code. An HTML widget works too.
3. Page Studio: open Settings, expand Scripts and paste into Head Section Tracking Code.
4. Save and update the page, then test on a desktop browser.

Opt-ins from a standalone pop-up are counted in that pop-up's analytics, not the page's. Leadpages also says standalone pop-ups cannot be attached to existing buttons on its own landing pages, so use on-page pop-ups for click triggers there.

Link to a Pop-Up and Use It Inside Content

In-content opt-ins: publish a pop-up as a text link or image and paste the code inside a blog post, next to the paragraph it relates to. The same pop-up can be published with several triggers, so one form can sit at the end of a post and in a sidebar.

A plain link: Leadpages' advanced publishing article explains how to build a direct pop-up URL from your Leadpages domain and the pop-up's ID, the value after data-leadbox-popup= in its code. On its own, that link opens the form in a new tab. Add the script part of the code to the page's head and it opens as an overlay instead.

Custom triggers: with the script on the page, adding the data-leadbox-popup attribute to any element, such as a menu item or image, turns it into a trigger. Leadpages cannot troubleshoot custom code on your site, so test carefully. Page Studio pages use the pop-up URL with an element's Open external URL action.

Publish Pop-Ups to WordPress and Other Sites

Any platform that accepts HTML and JavaScript can host the code. In WordPress, paste it into a Custom HTML block in the block editor, the Text tab of the classic editor, or a Text widget in a sidebar. Leadpages says the current WordPress plugin cannot pull pop-ups, and recommends a header and footer code plugin for site-wide timed or exit pop-ups; the legacy Connector plugin had a global pop-up setting. More detail is in the Leadpages WordPress plugin guide, and site builders such as Squarespace and Wix are covered in Leadpages with other platforms. To compare dedicated WordPress opt-in tools, see WordPress lead generation plugins.

To unpublish, remove the code from your site. Deleting the pop-up inside Leadpages does not remove it from pages where it is embedded. To find forgotten code, view the page source and search for leadbox.

Leadpages Pop-Up Not Working: Fixes

• Nothing appears: check the full snippet is in the page source and that your platform allows JavaScript.
• Opens in a new tab: only the URL was used, the code was pasted into a visual editor instead of an HTML or text editor, or other code corrupted it. Republish and copy fresh code.
• Timed or exit pop-up missing: test on a desktop, since these do not run on mobile, and check for a long delay or a days-between-showings setting.
• Works in one browser only: clear the cache and test in another browser or device.
• Video restarts when the pop-up opens: Leadpages publishes a short script fix in its pop-up publishing article.
• Required field you cannot remove: fields required by your email service cannot be overridden, so change them in that service.

On mobile, standalone pop-ups open as a separate page at a Leadpages URL to support older devices, which is expected behavior. For broader opt-in strategy, see lead capture pages.