ConvertedU Marketing Library Webinar Blog

Need help? You've come to the right place

What's New Getting Started Building Integrating Publishing

WordPress Plugin FAQs and Troubleshooting Guide

In this article, we cover the most common questions and issues related to Leadpages’ WordPress plugin.

Basic troubleshooting steps

Our plugin is designed to run on pretty much any WordPress site. However, since each site is so different, you may find the plugin isn’t working as expected. Here are some of the most common fixes if you run into problems…

Update WordPress and plugins

Firstly, we recommend making sure you’re running the latest version of WordPress. Our plugin is designed to work best with up-to-date versions of the platform. 

NOTE: Take care when updating WordPress if you use a custom theme or rely on lots of plugins. While updating your site shouldn’t cause major issues under most circumstances, certain plugins or themes may not be updated or designed to work with the latest versions of WordPress.

Then, look for and perform updates for any plugins you use regularly—including the Leadpages plugin.

You can update the Leadpages plugin from your WordPress Dashboard if you’ve installed Version 2.1 or above. If you have an older version, you can upgrade following our instructions here: Migrating from Previous WordPress Plugin Versions.

Update your PHP version

Your WordPress site must use PHP 5.6 or above for our plugin to function properly. One way to check your PHP version is with a plugin like this one: https://wordpress.org/plugins/display-php-version/.  

If your site runs on an earlier version, you’ll need to update to at least 5.6 through your web server/host. Every host handles this differently— you may need to contact yours directly, while others let you update through your admin tools. You’ll need to check with your web host directly to see how they recommend updating your site’s PHP version.

In addition your PHP must be running TLS 1.1 or higher.

Resolving plugin conflicts

Sometimes, conflicts arise between our plugin and others you use. Make sure that you’re running the latest version of WordPress as described above. If or once you are, we recommend following these steps for investigating plugin conflicts:

  1. Go through all of your installed plugins, then deactivate and delete any that you’re not actively using. Next, look for and perform updates for any that you do use regularly.
  2. Check if that solves the problem with your pages. If not…
  3. Deactivate every plugin except Leadpages and see if that solves the problem.
  4. If it does, turn your other plugins back on one-by-one—and test your pages each time to see if they still work. Doing this, you can narrow down which plugin is causing the conflict and deactivate it. 
NOTE: If you do find a plugin that conflicts with Leadpages, it’s helpful to let us know. While we may not be able to eliminate all plugin conflicts, if we know of specific issues, we may be able to update our plugin or work with third-party developers to resolve conflicts. 

Frequently asked questions

What should I do after receiving the error, "login failed error code: 401," when trying to log in to the plugin?

Often times WordPress or a password helper has auto-filled the login fields for our plugin with your WordPress login credentials, resulting in this 401 error. Instead, make sure to type in your Leadpages login credentials.

Why doesn’t my Leadpage have the menu and look of my other WordPress pages? 

Leadpages are published as Custom Post Types, so they won’t show up normally in your theme. By nature, most effective landing pages minimize options to navigate away from them. You can read more about Custom Post Type pages (which are an official part of WordPress) here: http://codex.wordpress.org/Post_Types

Many of our templates do include customizable navigation menus. If you’d like to provide navigation to other parts of your site from your Leadpage, we recommend using those templates—or, you may consider using a Leadbox instead of a Leadpage

Why can’t my other plugins see or access Leadpages inside WordPress?

Leadpages uses Custom Post Types for its “pages.” These types of pages are an official part of WordPress. Leadpages are setup as Custom Post Types because they require different behaviors, and if published another way the number of conflicts with other plugins and themes would be incredibly high.  

Unfortunately, there are some plugins out there that don’t recognize Custom Post Type pages. We encourage you to contact the developer of those plugins to see if it's possible for them to add this ability/functionality.

Learn more Custom Post Types here: http://codex.wordpress.org/Post_Types 

I updated my Leadpage, but my changes aren’t showing up in WordPress. What can I do?

Caching plugins can often interfere with changes updating properly on your WordPress site. If you use a caching plugin, check its settings and deactivate it if necessary, and/or clear its cache. Keep in mind, some plugins (such as many security plugins) cache your site even if caching isn’t their primary function.

If you can’t find a caching plugin, your browser’s cache may also prevent you from seeing your page’s updates. You can clear it by following our guide here

Why isn’t the URL to my page working?

It may be a subdomain issue—page URLs must follow your site’s main URL structure. The Leadpages plugin can only support the style of URL you set in the general settings, like so:

Your options are http:// or http://www—either is perfectly fine. That said, they aren’t interchangeable, so be sure to direct visitors to whichever you choose. For instance, if your URL is http://website.com/webinar, avoid posting a link to http://www.website.com/webinar.

To get around this, we recommend setting up a redirect on your server. That way, visitors who do go to http://www.website.com/webinar would land on http://website.com/webinar.

What will happen to my Leadpages on WordPress if I end my subscription?

Because an active subscription is required for the back-end services that power Leadpages (like our integrations engine), your Leadpages on WordPress will display an error if you cancel your account. If you do plan on canceling, we recommend deleting your Leadpages from WordPress before doing so.

How can I test out my Welcome Gate?

To view your Welcome Gate as a first-time visitor might, you’ll just need to trick your browser into thinking you’ve never been to your site before. One way to do this is to use your browser’s private or incognito mode—or, use another browser that you haven’t visited your site with.

Can my visitors skip over the Welcome Gate?

Your visitors can re-visit your site to bypass the Welcome Gate. If you’d like to give your first-time visitors the option to access your normal site, you can include a link on your Welcome Gate page. You’ll just need to edit the original Leadpage and add a link to it. It could be a button or text that says something like “Take me to the normal site.” 

When a first-time visitor clicks that link, they’ll be brought to its destination, effectively bypassing the Welcome Gate. 

If your Welcome Gate won’t turn off on mobile devices…

It’s likely you have a WordPress plugin or script that is redirecting the page on mobile devices. 

This is not something controlled by Leadpages—you will need to find the plugin or script on your site that is causing this and disable it to resolve the issue. To find the plugin that may be causing this, you can deactivate any plugins you know you’re not using. If you continue to encounter the issue, we recommend deactivating each plugin on your site one at a time to narrow down the one that is causing the issue. 

Once you’ve identified the plugin that is redirecting your pages to a mobile site and deactivate it, your Welcome Gate should turn off for mobile devices.

Can I protect Leadpages in my membership site?

Leadpages published to WordPress sites using our connector plugin are published in a way that may not allow them to interact with other WordPress plugins or pages. As such, as a general rule, you cannot protect a Leadpage using a WordPress membership site plugin.

You can however, protect Leadpages published as HTML files if you protect the folders where they’re published and/or use an on-page script that makes the page accessible to members only. We have an excellent guide on the steps to downloading your Leadpages as HTML for your server here: How To Publish Leadpages On My Own Server

PLEASE NOTE: You are welcome to add membership-style protection to your Leadpages, but we cannot provide support for it. You will want to contact your web host provider or other channels for any specific questions you may have about your site set up.

(Updated September 21, 2018)


Please let us know if you have additional questions.

You can always file a support ticket if you have additional questions by clicking the Support button in your dashboard shown here or clicking here to file a support ticket.

Was this article helpful?
Powered by Zendesk