The most common publishing error and their solutions are listed below:
1. No URL received.
📔 Explanation:
This happens when StoryChief does not receive a URL back from your website after you publish an article.
✅ Solution:
In many cases, this is a setting to change in the plugin.
For example, for WordPress, you could go to the StoryChief plugin and uncheck the test mode checkbox.
If you have a custom Webhook integration, please ensure to return us a response in the following structure.
{
"id": "THE_ID_OF_YOUR_POST_IN_YOUR_DB",
"permalink": "THE_URL_OF_YOUR_POST_IN_YOUR_DB",
"mac": "73c48056706a30ee21e6fc1cf065dd46f378236fb0875bbf5f8edc0ae34e5dea" }ℹ️ In some cases, you might not want to return a URL, (ex: if your integration is internal), which is ok, but please notice that you won't be able to publish the article to other channels if your primary destination does not return a URL.
2. There has been a critical error on this website.
📔 Explanation:
This means your website is having some issues.
✅ Solution:
Please check with your web developer.
3. Briefly unavailable for scheduled maintenance. Check back in a minute.
📔 Explanation:
Some websites go into offline mode when there is site maintenance or when you add/update a plugin/module.
✅ Solution:
Try later or check with your web developer.
4. Invalid response.
📔 Explanation:
The response StoryChief received back from your website is not correct. This mostly happens if you are using a custom Webhook integration.
✅ Solution:
Verify with your web-developer, StoryChief expects a response in this format.
{
"id": 1,
"permalink": "https://example.org/planet-or-plastic",
"mac": "73c48056706a30ee21e6fc1cf065dd46f378236fb0875bbf5f8edc0ae34e5dea" }Please check our API documentation for more information
5. Field (FIELD_NAME) is unknown.
📔 Explanation:
The field mentioned in the error was not found on your website.
This mostly happens if you mapped the storyChief field value to a field on your website, but then the field on your website was deleted/removed
✅ Solution:
Map the StoryChief field value to another field on your website.
6. Request failed with status code 401.
📔 Explanation:
you do not have permission to publish ( not authorised )
✅ Solution:
Please check with your website admin or web developer.
7. Slug/alias/path is already used.
📔 Explanation:
Each post on your website must have a unique slug (path), You can set this value when you are creating an article in StoryChief, but sometimes, if you also create content on your website using another workflow ( not via StoryChief ) the slug may be already used, which results in an error.
✅ Solution:
Change the slug in your article or go to your website and make sure the slug is not used by another page.
If you have a Webflow site, and you are sure the slug is not used, please try to publish your site again as this might be caching for an old deleted slug.
8. Request is expired or not valid
📔 Explanation:
<h1>Request is expired or not valid</h1> <p> The request that you have sent is not valid and therefore blocked.<br> Possible causes of invalid requests: </p> <ul> <li>Validity of the form has expired.</li> <li>The form does not contain token.</li> <li>Token of the form is invalid.</li>
Webhooks shouldn't/can't comply to CSRF, they should be disabled for that route.
✅ Solution:
Disable CSRF for the publishing webhook.
9. IP address is blocked
IP address is blocked, check if 52.18.212.210 is on the blocked list.
If so, add it to the whitelist.