All Collections
ConvertKit Integrations
How to set up the ConvertKit plugin on your WordPress website
How to set up the ConvertKit plugin on your WordPress website

A step-by-step guide to connecting your ConvertKit account to your WordPress website.

Updated over a week ago

Getting started with the ConvertKit WordPress plugin

The ConvertKit WordPress plugin lets you add ConvertKit content (such as your forms or products) to your WordPress website without having to deal with code. With it, you can also display custom content for ConvertKit subscribers with certain tags.

Our plugin is compatible with both self-hosted websites and hosted ones. Installing it is simple and takes less than five minutes, so let's get you set up!

NOTE: We've done our best to ensure the steps below will work for most people. But since WordPress is highly customizable, your installation process may not look exactly as what we've illustrated in our screenshots here. Reach out to our support team if you have questions.

How to install the ConvertKit WordPress plugin

1. Add the ConvertKit plugin to your WordPress website

From your WordPress admin dashboard, go to Plugins:

Click the Add New button at the top of the Plugins page.

Do a search for "convertkit" in the search bar at the right side of the page, then click the Install Now button for the plugin called "ConvertKit – Email Marketing, Newsletter, Subscribers and Landing Pages."

When the plugin installation is complete, the Install Now button will be replaced by an Activate button. Click Activate to activate the ConvertKit plugin.

2. Add your ConvertKit API key

A ConvertKit Setup Wizard will launch:

Click the Connect button to connect your ConvertKit account with your WordPress website. (If you don't already have a ConvertKit account, register one here first.)

Use the links provided on the Connect your ConvertKit account page to copy and paste your API key and API secret into the setup wizard. They allow the plugin to securely access your ConvertKit account data.

Alternatively, you can find your API key and API secret by going to the Advanced Settings page of your ConvertKit account.

Click Connect to proceed to the next step.

3. Choose the email form to display on your WordPress posts and pages

At the Display an email capture form page, select the default email form you want to display below all your WordPress posts and pages.

(To set up a default email form for your WooCommerce product pages, follow the instructions here instead.)

If you don't want to display a default form on your posts and/or pages, select the "Don't display an email subscription form on posts/pages" option.

You can also disable your default form, or show a specific form, for certain posts, post categories, and pages. Learn how to do so here.

Click Finish Setup to complete the basic setup. πŸŽ‰

From here, you can click the Dashboard button to return to your WordPress dashboard.

But if you want to configure more of the ConvertKit plugin's settings, click the Plugin Settings button to load the General Settings page.

(You can also navigate to the General Settings page by clicking Settings on your WordPress sidebar, followed by ConvertKit.)

For this article, we're going to focus on configuring these advanced settings:

Read these other articles if you want to start customizing your WordPress website with your ConvertKit content instead!

Disabling the ConvertKit plugin's JavaScript and CSS functionality

At the bottom of the General Settings page, you can enable the Disable JavaScript and Disable CSS settings to prevent the ConvertKit plugin from loading JavaScript and CSS files respectively.

Doing so will prevent the plugin's features that rely on JavaScript and CSS from working as intended, so we recommend leaving these settings unchecked unless you have a reason for enabling them.

For example, you may want to temporarily disable the ConvertKit plugin's JavaScript functionality to troubleshoot if it is causing a conflict with another WordPress plugin.

Enabling the debug log

The General Settings page's Debug setting will generate a record of your ConvertKit plugin activity.

This record, or debug log, will be displayed on the Tools page of your ConvertKit plugin settings.

If you contact support about a ConvertKit issue on your website, our support team may ask you to enable the Debug setting so they can obtain a debug log for troubleshooting the issue.

Otherwise, since generating the debug log may slow down your website, we suggest leaving the Debug setting unchecked.

Tracking ConvertKit subscriber activity on your WordPress website

On the Advanced Settings page in your ConvertKit account, you'll find a setting to "Add subscriber_id parameter in email links."

Enable this setting to track the ConvertKit subscribers who have visited the WordPress web pages you've linked to in your emails. It's also helpful for:

  • Tagging subscribers who visit certain web pages, and

  • Displaying custom page content based on the tags your subscribers have in your ConvertKit account.

For now, however, let's start adding your ConvertKit content to your website!

Did this answer your question?