Leadpages WordPress Plugin (2026): Install, Publish and Fix Common Issues

The Leadpages plugin for WordPress lets you design a page in Leadpages and serve it at a normal address on your WordPress site, such as yoursite.com/free-guide, without touching your theme. It is free to install, but it only publishes from a paid Leadpages account. This guide covers the setup, every publish option the current plugin offers, how updates and pop-ups behave, and the fixes for the problems people search for most.

What the Leadpages WordPress Plugin Does

The plugin is a connector rather than a page builder. You build and edit the page in Leadpages; the plugin fetches that page and serves it at the WordPress URL you choose. Leadpages says the page loads on your own domain with your existing SSL certificate, with no iframe and no redirect to a Leadpages subdomain. For the new Leadpages platform, the plugin listing adds that visitor cookies are passed through, so per-visitor features such as A/B tests keep working on the WordPress copy.

Because the page does not use your theme, plugins that restyle WordPress pages, theme updates and page builders installed on the site do not change its layout. The flip side is that your theme's header, menu and footer do not appear on the page either. If you want people to be able to click back to the rest of the site, choose a Leadpages template that includes a navigation bar. Whether this hosted approach or a native WordPress page is the better fit is covered in Leadpages vs WordPress.

Which Leadpages Plan You Need

Leadpages' help center states that the WordPress plugin is available on paid plans only. Trial users are told to end the trial early or upgrade before the plugin will publish; the article names the Grow, Optimize and Scale plans in that sentence and does not mention Pro or Business, so if you are on one of the lower plans, check with Leadpages support before you rely on the plugin. You can still use the 7-day free trial to build and preview the page itself. Current prices and the per-plan limits on sites and integrations are in the Leadpages pricing guide.

How to Install the Leadpages Plugin and Connect Your Account

1. Publish a page in Leadpages first. Only published pages appear in the plugin's dropdown.
2. Install the plugin. In WordPress, go to Plugins, then Add New, search for "Leadpages", click Install Now and then Activate.
3. Connect. Click Leadpages in the left-hand admin menu, then Connect to Leadpages.
4. Sign in and authorize. Log in to Leadpages and click Authorize. If you manage several accounts, for example as an agency, pick the one that holds the pages for this site.

You only connect once per WordPress site. To switch to a different Leadpages account later, open Leadpages, then Settings, click Disconnect and reconnect with the right account.

How to Publish Leadpages to WordPress

1. Go to Leadpages, then Add New Page in the WordPress admin.
2. Choose the page from the dropdown.
3. Enter a URL slug. A slug of "launch" serves the page at yoursite.com/launch.
4. Click Publish, then open the URL in a private browser window to confirm it loads.
5. Submit the form once and check that the test lead reaches Leadpages and your email tool.

To link the page from your site menu, go to Appearance, then Menus, add a Custom Link with the page URL and save the menu. You can also link to it from a blog post or button like any other page on your site.

Homepage, 404 and Welcome Gate Pages

Besides normal pages, the current plugin supports two special placements. The plugin listing on WordPress.org describes them like this:

• Homepage: tick "Use as my homepage" (or leave the slug empty) and the page replaces your WordPress homepage. Unpublishing it brings the WordPress homepage back. Leadpages also mentions testing homepage variants this way.
• 404 page: tick "Use as my 404 page" and visitors who reach a broken or unknown address see your Leadpages page, still returned with a proper 404 status. Unpublishing restores your theme's 404 page.

The welcome gate, a page shown once to first-time visitors before they reach the site, belongs to the older Leadpages Connector plugin for Classic pages. Leadpages now labels that plugin as legacy, and neither the current plugin listing nor the new help article mentions a welcome gate, so do not plan a campaign around it on a new install.

Pop-Ups and Leadboxes on WordPress

For pages served through the plugin, Leadpages says every feature, pop-ups included, works the same as it does on a Leadpages domain. The plugin listing notes that the new platform adds its embed script to the page when a pop-up is shown.

Putting a pop-up on your ordinary WordPress posts is a separate job. For Classic pop-ups (the tool long known as Leadboxes), Leadpages documents copying the pop-up's embed code from its publishing options and pasting it into a Custom HTML block in the block editor, the Text tab of the Classic editor, or a Text widget under Appearance, then Widgets. Site-wide timed and exit pop-ups were tied to the legacy plugin, and Leadpages' Classic docs point to a header-and-footer code plugin as the alternative. If you mainly want WordPress-native pop-ups and forms, compare the options in WordPress lead generation plugins.

Updates, Multiple Pages and Multiple Sites

A common question is whether WordPress updates when Leadpages says a page is updated. With the current plugin it does, because the plugin fetches the latest published version on every visit. The catch is the word published: changes go live only after you click Publish in the Leadpages editor. If you still see the old version, a caching plugin or CDN is usually serving a stored copy; purge it and reload in a private window.

You can assign as many pages as your plan allows, each with its own slug. Each WordPress site needs its own installation and connection, and that includes each site in a Multisite network. To remove a page from WordPress, open Leadpages, then Pages, and delete the assignment; the page itself stays in your Leadpages account. Deactivating the plugin stops every assigned page from serving until you reactivate it.

Moving From the Old Leadpages Connector

Sites set up years ago may still run the Leadpages Connector (version 2.3.13). Leadpages says edits made in the new editor will not reach those URLs until you switch. Back up the site, deactivate and delete the Connector first, then install and activate the current plugin and sign in. Leadpages warns against using Upload Plugin with Replace current while the Connector is active, because the new plugin can end up inactive. After signing in, check the import summary under Leadpages, then Pages, and reconnect any page marked as not found.

Leadpages WordPress Plugin Not Working: Fixes

Two older limits are also worth knowing. Leadpages' Classic FAQ says WordPress membership plugins generally cannot protect pages served this way, and that pages show an error if your subscription ends, so remove them from WordPress before cancelling.

Alternatives to the Plugin

If you would rather keep everything inside WordPress, a page builder or landing page plugin may suit you better; the WordPress landing page plugin roundup compares them, and how to create a landing page in WordPress walks through the block editor method. If your site is not on WordPress at all, you can publish Leadpages pages to your own domain or subdomain instead, as shown in using Leadpages with a GoDaddy domain. A full list of connection options is in the Leadpages integrations hub, and the wider tool set is covered in Leadpages features.