Connecting Your Domain Using the WordPress Plugin

You can publish landing pages to your WordPress domain through our WordPress Plugin, without the complexity of DNS record and CNAME setup. 

What you will need:

• Self-hosted WordPress site,
• Supported version of WordPress (4.1.5+), installed at either the root or subdomain,
  • Tested up to 6.3.
• Access to your site admin,
• PHP version 7.2 or higher,
• PHP cURL enabled version 7.34.0 or higher, 
• OpenSSL version 1.0.1 or higher, and 
• TLS 1.2 or higher

Updates: September 5th, 2023

We've updated our WordPress plugin with improved security enhancements to increase your landing pages' resilience against attacks. You will need to update your WordPress plugin to ensure that you're running the most up-to-date version. To update the plugin:

1. Log in to your WordPress dashboard.
2. Navigate to Plugins→ Installed Plugins.
3. You’ll notice an Update Available message for your Unbounce plugin.
4.  Click Update Now. 

Adding a WordPress Domain to your Unbounce Client

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.

1. Log into your Unbounce account.
2. Navigate to the Client where you'd like to install a WordPress domain.
   • If you only have one client in your account, skip this step.
3. Select Domains on the left-hand side of the app.
4. Click the Connect a Wordpress Domain button:
   
5. A new window will appear; enter your WordPress address (URL) in the blank field:
   
   
   • Make sure your domain within Unbounce matches your WordPress Address (URL) exactly, including capitalization. To double-check your WordPress domain, click More Info on WordPress Domains in Unbounce for steps.
6. Click the blue Create a WordPress domain button to add the domain.
7. A new window will appear with set-up instructions: 
   
   
8. Click Install Unbounce's WordPress Plugin. If you're signed into WordPress already, you'll automatically be routed to your admin page in WordPress. 

Installing and Activating the Unbounce Plugin in WordPress

There are three key steps to installing and enabling the plugin with Unbounce: Install, Activate, and Authorize the plugin in WordPress. 

Step 1: Install

Log in to your WordPress account ('wp-admin' portion of your WordPress account).

1. Navigate to the Plugins section of your account. 
2. Click Add New. 
3. Search for Unbounce on the left-hand side search bar.
4. Click Install Now:
   

For more insight on installing a plugin, see WordPress' documentation: How to Install a Plugin.

Step 2: Activate

1. From the same Plugins page, click Activate:
   

Step 3: Authorize

Lastly and most importantly, Authorize the plugin to ensure your WordPress and Unbounce accounts are linked.

1. On the left-hand menu of WordPress, scroll down to Unbounce Pages:
   
2. From the page that appears, click Authorize with Unbounce:
   

Your list of Unbounce pages published to WordPress will appear here.

That's it; you've successfully installed, activated, and authorized with WordPress. Now, navigate back to Unbounce to link this domain to your pages. 

Confirm that the domain is configured

Back in the Domains tab in Unbounce, continue the prompts from the window (2. Change URL, and 3. WordPress icons).

Click Close, and you'll see your WordPress domain in Unbounce:

Publishing Pages to your WordPress Domain

To publish a landing page to your WordPress domain,

1. Navigate to Unbounce and click on a page from the All Pages screen to launch the Page Overview.
2. Click on the current URL at the top of the Page Overview:
   
3. Click the Domain Name drop-down menu to choose your WordPress domain. The WordPress logo will appear at the corner.  
4. Change the Page Path by editing the text to your desired page path:
   
   
5. Once you've finalized your page URL, click the blue Save URL button to save your selection!

Now you're ready to publish your page!

More Info on WordPress Domains in Unbounce

Publishing over pre-existing content

When you publish a page to a WordPress domain, that page will be served over top of any existing page hosted on your WordPress site. 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, ensure you have purchased an SSL certificate for the WordPress domain.

More on that within our documentation: How do I get an SSL certificate for my WordPress domain in Unbounce?

Mismatching of the domain added in Unbounce and WordPress

A common reason for the WordPress plugin failing to authorize is a mismatch between the domain added in Unbounce and the address in WordPress. 

For example, if WordPress is installed on www.comic-sans.com, but the domain added into Unbounce is comic-sans.com (without the 'www'), the plugin won't authorize.

To resolve this, the domains must match exactly.

To double-check your WordPress domain,

1. Log into your WordPress admin,
2. Navigate to your Settings, then General Settings.
3. Scroll down to check that the domain under WordPress Address (URL) matches the one in Unbounce:
   

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.