Publishing Unbounce Landing Pages with the WordPress Plugin

Follow

Note

We cannot support WordPress websites that use versions of TLS older than 1.2.

Great news! If you’re an Unbounce customer on a paid plan, you can publish landing pages to your WordPress domain through our WordPress Plugin, without the complexity of DNS record and CNAME setup. Additionally, if you’re an Agency user, you can hit the ground running and onboard WordPress clients and authors seamlessly.

This article will help you out with:


Adding a WordPress Domain to your Unbounce Account

What you will need:

  • Self-hosted WordPress site with supported version of WordPress, installed at either the root or subdomain.
  • Access to your site admin.
  • PHP version 5.6 or higher.
  • PHP cURL enabled version 7.34.0 or higher.
  • OpenSSL version 1.0.1 or higher.

WordPress must be installed on your root domain (such as www.myawesomecompany.com) or subdomain (such as promo.myawesomecompany.com). WordPress sites installed on a path (such as www.myawesomecompany.com/new) are not currently supported. If your WordPress site is installed on a path, such aswww.myawesomecompany.com/new, lead tracking, conversion counters, and form submission will not work.

Adding a WordPress Domain to Your Unbounce Account:

  1. Log into your Unbounce account.
  2. Click “Add a Domain” under the Client Account you’d like to use. Please note there is no charge for adding a WordPress Domain.
  3. Select “Add a WordPress Domain”.
  4. Enter in your WordPress Address (URL).

    You can find your WordPress URL by logging into your WordPress site, selecting “Settings” and copying the WordPress Address. 

  5. Click the green “Add a WordPress Domain” button in the bottom right to complete the addition.
Make sure your domain within Unbounce matches your WordPress Address (URL) exactly. In this example, WordPress is installed on the naked domain wanderingelephants.com. If your domain within Unbounce is www.wanderelephants.com, the plugin won't be able to authorize.  

Adding the Unbounce Plugin to Your WordPress Account

  1. Log in to your WordPress account.
  2. Navigate to the "Installed Plugins" section of your account.

  3. Find the Unbounce WordPress Plugin and follow the on-screen instructions to install and activate.
  4. From your WordPress menu, authorize the Unbounce Plugin by selecting the "Unbounce Pages" plugin from your WordPress menu, and select the “Authorize” button.
  5. A screen will appear asking for authorization.
  6. On your Installed Plugins screen, your list of Unbounce pages published to WordPress will appear. If no pages appear, return to Unbounce Page Management and publish your pages to your WordPress domain from inside Unbounce.

Publishing Pages to your WordPress Domain

  1. To publish a page to your WordPress domain, use the Change URL button in the Unbounce Page Overview.

Additional Notes

Publishing over pre-existing content

When you publish a page to a WordPress Domain and URL, that page will be served over top of any existing page that may be hosted on your WordPress site. Don’t worry, your pre-existing content won’t be deleted, but visitors to the URL will see the Unbounce content you’ve published there.

Security and SSL

Please note that Unbounce cannot provision SSL certificates for WordPress domains that are not SSL secured. To publish SSL secured landing pages to a WordPress domain, make sure that you have purchased an SSL certificate for the WordPress domain.

Robots.txt 

For tracking purposes the Unbounce page builder will reformat outgoing links on a page by inserting either a "clkg" (tracked as conversion goal) or "clkn" (not tracked as a goal) wrapper around the link. For example:

http://unbouncepages.com/blank-page/clkn/http/unbounce.com/

 

In order to prevent these formatted links from appearing in search results please add the following to your robots.txt file in Wordpress:

Disallow: */clkn/*
Disallow: */clkg/*

 

Robots.txt with the Yoast Plugin

If you are using the Yoast plugin for SEO you can add the above code under SEO -> tools from your Wordpress dashboard. 

Screenshot

yeost_robot_txt.png

Mismatch of domain added
 
A common reason for the WordPress plugin failing to authorize is a mismatch between the domain added in Unbounce and the address in WordPress. 
 
The WordPress address can be found by logging into WordPress, then going under Settings > General.
 
For example, if WordPress is installed on the naked domain wanderingelephants.com (without the 'www'), and the domain added into Unbounce is www.wanderelephants.com (with the 'www'), the plugin won't authorize.  To resolve this, the naked domain will have to be added into Unbounce. 
mceclip0.png
 
 

Supported versions of WordPress

  • 4.1.5+ 
  • Tested up to 4.7.5

Known Issues

WordPress 'Default' URL Structure

By default WordPress uses web URLs which have question marks and lots of numbers in them; however, this default structure will not work with the Unbounce Plugin.

You can update your WordPress Permalink Structure by visiting yourdomain.com/wp-admin/options-permalink and changing to anything other than the default WordPress setting.

WordPress caching plugins can cause conflicts

Some WordPress caching plugins can cause conflicts with the Unbounce Pages plugin. If you experience any issues with scripts, republishing, stats, or form submissions on your Published pages, please let us know and send us a list of the 'Active' plugins installed on your WordPress Admin so we can investigate further.

Unpublishing Pages

When several pages are published to WordPress (two or more) and each of them is then unpublished, the last page to be unpublished may throw a 404 error rather than displaying the default WordPress 404 page.

It should resolve itself shortly.

Instead of seeing a WordPress 404 page like this:
Instead_of_seeing_a_WordPress_404_page_like_this.png

You will see a 404 page like this:

You_will_see_a_404_page_like_this.png

Cached 404 Page on WP Engine

If a page is visited prior to the page being served from the Unbounce Plugin, WP Engine may cache the 404 page from the WordPress site. Once the page is published, it can take WP Engine up to 24hours to flush it's cache resulting in the 404 page being served although the page is being served properly though the Unbounce Plugin.

To work around this, you can do a manual flush of WP Engine cache when a new page is being published for the first time.

Troubleshooting WordPress Plugin Technical Issues

Check out Troubleshooting WordPress Plugin Technical Issues for help with:

  • Identifying common WordPress Plugin issues and diagnosing their potential causes.
  • Providing our support team with the plugin diagnostics they'll need to diagnose potential causes for uncommon WordPress Plugin issues.

Was this article helpful?
18 out of 23 found this helpful