Getting started with the Kit WordPress plugin
The Kit WordPress plugin lets you add Kit content (like Forms and 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 (on the Business plan or higher). 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 work for most people. But since WordPress is highly customizable, your installation process may not look exactly as shown in our screenshots. 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 look for the plugin called "Kit (formerly ConvertKit) – Email Newsletter, Email Marketing, Membership, Subscribers and Landing Pages."
Click Install Now to install the plugin.
When the plugin installation is complete, the Install Now button will be replaced with 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 Kit 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. Configure the plugin
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.
Check or uncheck the Usage tracking checkbox depending on whether you want to allow usage tracking. Learn about usage tracking below.
You can also disable your default Form or show specific Forms 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 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 found at the bottom of the General Settings page:
Read these other articles if you want to start customizing your WordPress website with your Kit content instead:
Enabling the debug log
The General Settings page's Debug setting generates 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.
Disabling JavaScript and CSS
Enable the General Settings page's 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's causing a conflict with another WordPress plugin.
Enabling usage tracking
The General Settings page's Usage tracking setting helps us better understand how users interact with the Kit plugin and the types of environments the plugin runs in.
With these insights, we can continuously improve the plugin's performance, compatibility, and overall user experience for all Kit users.
Usage tracking is an opt-in setting that is disabled by default. By enabling it, you give us permission to collect a limited amount of non-sensitive technical information to guide our development and testing process.
Specifically, we'll track:
PHP version: This information helps us know which PHP versions to support and test against, reducing errors and ensuring smooth updates.
WordPress version: This information lets us identify which WordPress versions are most commonly used, so we can maintain compatibility and prioritize testing.
MySQL version: This information helps us ensure our database tables and queries are optimized for the most-used MySQL versions.
Kit plugin version: This information lets us quickly identify which plugin versions may be affected by bugs or performance issues and release fixes faster.
Server software: This information helps us understand which hosting providers and environments our users are running on, so we can test new releases accordingly and identify potential hosting-specific issues.
Theme and plugin names and versions: This information lets us test the Kit plugin with the most popular themes and plugins to avoid conflicts and maintain compatibility.
Kit plugin settings: This information helps us understand which features are most used, so we can focus on making improvements where they matter most.
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: