We love WordPress! Not only because it is a robust CMS, but also because of the enormous community and millions of plugins available. Often times though, plugins can cause incompatibility issues with each other. If you are experiencing difficulties connecting or publish to your WordPress site, we recommend using this help article of common problems and their solutions to both diagnose and solve issues you may be experiencing.

1. URL mismatch

When connecting you WordPress website StoryChief will ask you for your website URL.

Entering your url with http:// of https:// makes a difference.
http://yourdomain.com
https://yourdomain.com

2. Custom 404 plugins

We have seem issues arising when people use a custom 404 plugin in WordPress.
The solution is to add an exception for: http(s)://yourdomain.com/wp-json/storychief/webhook

3. Under construction plugins

Most under construction plugins will also disable the WordPress API.
The solution is to disable the plugin. Most of the time this means when your website is ready to go live.

4. Caching plugins

  • Add an exception for: http(s)://yourdomain.com/wp-json/storychief/webhook
  • Also exclude our user agent: Story Chief

5. Firewall plugins

We have seen people having issues with Firewall plugins too.
The solution is to add an exception for: http(s)://yourdomain.com/wp-json/storychief/webhook

6. WP-Rest may be disabled

Check to see if the WordPress Rest API is disabled. You tell if it is by visiting
http://yourdomain.com/wp-json/wp/v2/posts
This page should show something similar to this:

If you received an error, it means the WordPress Rest API is disabled.
You can enable it by activating your permalinks in WordPress.

Visit SettingsPermalinks within WordPress and without making any changes click Save changes. This causes WordPress to flush its rewrite rules, and can often resolve issues like this. Think of it as giving WordPress a gentle nudge to say “hey, I think you’re a little confused.”

7. You don't have pretty permalinks enabled in WordPress

Without pretty permalinks enabled in WordPress the WordPress JSON API nor StoryChief can work properly.
Double check your website does not have the option 'plain' set as the permalink setting.

8. A conflict with a different installed plugin

Temporarily disable all plugins on the site except for StoryChief, then re-enable them one by one, checking the connection as you go. This will help narrow down whether or not a particular plugin is interfering with the WP REST API. If you’re able to isolate one or more plugins causing issues with the REST API, we recommend installing any available updates for them and/or reach out to those plugin developers and let them know.

9. A conflict with your theme

Temporarily switch to one of the default WordPress themes (e.g. Twenty Twenty), then check the connection again. If it's still not working, then it’s unlikely to be anything within the theme causing issues. If switching to a default WordPress theme resolves the issue, then the root cause is likely in your site's theme. We recommend reaching out to your developer or your place where you purchased it. If there’s anything in the theme’s code that might be conflicting with the REST API, they’ll want to know so they can fix it.

Did this answer your question?