Getting started with the Kit WordPress plugin
The Kit WordPress plugin lets you add Kit content (such as your forms or products) to your WordPress website without dealing with code. With it, you can also display custom content for Kit 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 Kit WordPress plugin
1. Add the Kit plugin
From your WordPress admin's left sidebar, go to Plugins > Add New Plugin:
Search for "kit" in the search bar at the top right of the page, and then click the Install Now button for the plugin called "Kit (formerly ConvertKit) – Email Newsletter, Email Marketing, 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 Kit plugin.
2. Grant WordPress access to Kit
A Kit Setup Wizard will launch:
Click the Connect button to connect your Kit account with your WordPress website.
NOTE: If you quit the Kit Setup Wizard without completing setup, you can resume setup by going to Settings > Kit from your WordPress left sidebar:
Then, click this Connect button:
When you click Connect, you'll be directed to the Kit login page to log in to your account (or create a new account if you don't have one).
After logging in to your Kit account, you'll see a message: "WordPress is requesting access to your account."
Click Grant access to WordPress to proceed.
NOTE: If you're a team member of multiple Kit accounts, use the dropdown menu to select the account you want to connect to WordPress.
3. Choose an email form to display on WordPress posts and pages
On 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 this here.
Click Finish Setup to complete the basic setup. 🎉 You'll see this screen next:
From here, you can:
Return to your WordPress dashboard by clicking Dashboard
Configure more settings by clicking the Plugin Settings
(You can also navigate to the Kit plugin's settings by clicking Settings on your WordPress sidebar > Kit.)
In this article, we'll focus on configuring these advanced settings:
Read these other articles if you want to start customizing your WordPress website with your Kit content instead!
Disabling the Kit plugin's JavaScript and CSS functionality
At the bottom of the Kit plugin's General Settings page, you can enable the Disable JavaScript and Disable CSS settings to prevent the Kit 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 Kit 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 Kit plugin activity.
This record, or debug log, will be displayed on the Tools page of your Kit plugin settings.
If you contact support about a Kit 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 Kit subscriber activity on your WordPress website
On the Advanced Settings page in your Kit account, you'll find a setting to "Add subscriber_id parameter in email links."
Enable this setting to track the Kit 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 subscribers have in your Kit account.
More information on this in our guide to customizing your Kit subscribers' experience on your WordPress website.
For now, however, let's start adding your Kit content to your website!