All Collections
Wordpress: General Troubleshooting
Wordpress: General Troubleshooting

Help with tips for troubleshooting the ConvertKit WordPress Plugin

Updated over a week ago

First, we recommend using the plugin for three primary reasons:

  1. To set a default Form at the bottom of every blog post or page. This way, you don't have to edit all your posts and pages to have a Form.

  2. To set a CK Landing Page as your WP page.

  3. To Tag Subscribers that visit a specific page on your site, or alternatively to show them custom content on that page.

Outside of these three, we highly recommend against using the Plugin, or even the WP shortcode (and in most cases the HTML embed), unless there is a specific reason. For all other use-cases, which is the great majority, we recommend the Javascript embed, since it usually creates fewer conflicts.

So, if you are encountering an issue that relates to using the WP shortcode, a plugin widget, etc, please try the Javascript embed to see if that resolves the issue.

Common WordPress Issues

My Form dropdown menu is missing some of my Forms or Landing Pages

Go to the plugin page (Settings > ConvertKit) and click the Save Changes button.

If that doesn't get the plugin to load the latest forms, try disconnecting and reconnecting the integration.

  • Again on the plugin page, select your API Key and Secret and copy them somewhere else, then delete them. Click the Save Changes button. Now your plugin is disconnected from your account.

  • Re-add the API Key and Secret, and click Save Changes. Now your plugin should be reconnected and pull the latest list of Forms and Landing Pages from your ConvertKit account.

Now go back to your page or post and refresh the page and see if the option is available in the dropdown now.

My CK Landing Page as my WP page isn't working

Make sure the editor is completely blank. There should be no content at all on the page. Double-check that the Form dropdown is set to "None" and the Landing Page dropdown is set to the Landing Page you want to show. Only if all three of these things are true will the plugin be able to load the Landing Page in place of the the Wordpress page.

If the system detects any content added on the page, or if there is a ConvertKit Form trying to load, it will choose not to display the Landing Page at all.

I embedded my Form but it looks or behaves wrong

Depending on where the Form is embedded or the method used to embed it, style conflicts may exist with the site's design. For this reason, we recommend using the Javascript embed code and embedding it lower on the page (even in the footer if it's a modal or slide-in Form), creating less chance of things being overwritten or encountering style conflicts.

I can't trigger a Modal by a link click

There are two common reasons for this.

If you're making a button using your Wordpress theme's interface, that usually won't work since most themes don't allow adding attributes to buttons—just a URL. In this case, you'll need to create your own button (likely using HTML) in order to get it to work.

The second most common issue is that the Javascript embed of the Form is missing. Even though you've added the Link attribute that triggers the modal, the Form code itself still needs to be embedded on the page. Otherwise the link may open the Form in a new tab.

Did this answer your question?