Troubleshooting
Something not working as expected? Most issues have a quick fix. Here are the most common problems and how to resolve them.
My run failed
Open the run from the Runs page and check the log. The log shows each step of the pipeline and highlights where the failure occurred. Common causes:
- Service URL unreachable — Wonderblogs couldn't fetch your brand context. Verify the URL is correct and publicly accessible.
- Invalid API response — Your Service URL returned data that doesn't match the expected format. Check the API Documentation for the required response schema.
- Authentication error — The API key in your settings may be incorrect or expired. Re-enter it in Settings.
Post published but didn't arrive
If the run completed but your blog didn't receive the post:
- Verify your Webhook URL is correct and reachable.
- Make sure your endpoint returns a 2xx status code on success.
- Check for temporary network issues — you can use the Re-Push button on the post detail page to try again without re-generating the content.
Post is stuck in READY_TO_PUSH
This means the content was generated and approved, but publishing failed. The most likely cause is a webhook error. Check your webhook endpoint, then use Re-Push to retry.
Scheduled runs aren't triggering
- Confirm a cron expression is set in your site's Settings. If the field is empty, no scheduled runs will execute.
- Cron expressions use UTC time. Double-check that the schedule aligns with your expectations when accounting for time zones.
- If you've hit your monthly run limit, scheduled runs are skipped until the next billing cycle.
Content doesn't match my brand
The quality and relevance of generated content depends heavily on your Brand Context. To improve results:
- Fill out all nine sections of your Brand Context, especially Brand Identity, Tone of Voice, and Instructions.
- Be specific in your instructions — instead of "write professionally," describe exactly what that means for your brand.
- Use the Content Authenticity section to ban words or phrases that don't belong in your content.
- Review and update your Brand Context regularly to keep it aligned with your evolving messaging.
Images don't match my style
AI-generated images improve over time with feedback. Here's how to steer them:
- Define your Visual Identity in the Brand Context page — including color palette, style, mood, and any visual elements to avoid.
- Rate images in the Feedback tab on the Images page. After 5 or more ratings, Wonderblogs learns your preferences and adjusts future generation accordingly.
I hit my run limit
Your monthly run allowance is shared across all sites. When it's exhausted, all runs are blocked until the next billing cycle. You can upgrade to Pro at any time from the Billing page to increase your limit immediately.
Still stuck?
If none of the above solves your issue, double-check your site's setup checklist on the Site Overview page — it flags missing configuration. You can also review the full run log for detailed error messages from each pipeline step.