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.
2. Custom 404 plugins
We have seen 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/password protected
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.
If your website is protected with a username and password using a .htaccess file, you may be able to still connect by using this address format for your WordPress URL field: http(s)://username:firstname.lastname@example.org/.
Depending on the plugin there might be a setting available to enable WP API. If so you can enable it that way as well.
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)
Add an exception to your Firewall for StoryChief. See this article.
6. Disabled WP-Rest
Check to see if the WordPress Rest API is disabled. You tell if it is by visiting
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 Settings ➜ Permalinks 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. Disabled pretty permalinks 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.
10. Publishing results in "Operation timed out after"
This errors typically pops up when your WordPress website has cron jobs configured to run on page request. When StoryChief publishes to your website, your website decides to first run some cron tasks, and therefore takes a very long time to respond back. This can be fixed by switching cron jobs to be run via a crontab, this will also greatly improve the speed for any of your visitors. More info in the WordPress docs.
If the issue would still persist, something else is greatly impacting your website's speed and should be addressed