All Collections
Troubleshooting
Testing for Conflicts on WordPress
Testing for Conflicts on WordPress

How to determine if other plugins or themes on your WordPress site are conflicting with ConvertKit's WordPress plugins.

Updated over a week ago

Issues with WordPress plugins are often caused by conflicts with other plugins or themes installed on the same site. The following steps will help to confirm if such conflicts are happening.

First things first, however.

Step 0: Back Up Your Site

The following steps should not cause damage to your site or its data, as they are simply activating and deactivating themes and plugins. It is wise, however, to always back up your site before debugging out of an abundance of caution.

We do not recommend proceeding with the rest of the steps unless you have a backup of your site.

Ready to run a few simple tests?

Let's do it.

Step 1: Activate a Default Theme

Once you've backed up your site, it's time to activate a default WordPress theme. These are the free themes included by default with most WordPress installations, with names like Twenty Twenty, Twenty Nineteen, Twenty Seventeen, etc.
โ€‹
If you don't have one installed on your site, you can download them for free on WordPress.org and install them manually.
โ€‹
First, activate the default theme. Then, go to Settings > Permalinks in your wp-admin, and click "Save Changes" without actually changing anything. It sounds funny, but this will refresh the permalinks on your site, which will be important for debugging.

Now try to recreate the issue that brought you here in the first place.

Does the issue persist when the default theme is active?

If yes, proceed to Step 2.

If it does not persist, then the theme you had active before switching to the default theme is likely the cause of the issue!

Step 2: Testing Plugins

If the issue persists when the default theme is active, leave the default theme active.

Go to the Plugins in your wp-admin, and deactivate one of your plugins that is not ConvertKit (or ConvertKit for WooCommerce, etc.)

Next, do the "refresh permalinks" step, just like before.

Now try to recreate the issue. If the issue is still persisting at this point, repeat steps 1-4 above until you have gone through the entire list of plugins within your wp-admin. Make sure to keep each plugin deactivated as you go.

If the issue does not persist:

  1. Leave the plugin deactivated.

  2. Re-activate your original theme.

  3. Try recreating the issue that brought you to this article and note what you find.

Step 3: Next Steps

If you have confirmed that your theme is causing the issue:

  • Contact the theme's support team for assistance.

If you have confirmed that a plugin other than a ConvertKit WordPress plugin is causing the issue:

  • Contact that plugin's support team for assistance.

If the issue persists when default theme is active, and the only plugins active are the ConvertKit WordPress plugin (or in the case of the ConvertKit for WooCommerce plugin, just ConvertKit for WooCommerce and WooCommerce):

  • Please contact our support team for further assistance, and mention that you did these exact steps.

Did this answer your question?