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 WordPress.org websites and hosted WordPress.com 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!
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.
More information on doing so in our guide to customizing your ConvertKit subscribers' experience on your WordPress website.
For now, however, let's start adding your ConvertKit content to your website!