If something goes wrong
Common problems and how to isolate the cause
Article generation doesn't start
- Pro license not activated: check the status under "Settings > License Activation." Generation is blocked while it's unactivated
- API key not set: check that "Settings > API Keys" has a key for body text generation
- WP-Cron isn't running: if the site gets little traffic, processing may not advance. Reopening the admin screen can nudge it forward
It fails partway through
You can see the error details under "Sorabun > Jobs / History." Common causes:
| Error | Cause and fix |
|---|---|
| 429 / rate limit | An API rate limit. You may have hit the free-tier cap. Wait a while, or switch to a paid tier |
| 401 / 403 | The API key is wrong or lacks permission. Re-enter the key |
| Timeout | The server's execution time limit. Reducing the character count or the number of diagrams can help it complete |
| Error during image generation | The image key isn't set, or the model name is incorrect |
Failed jobs can be retried. If a job had already made progress, it resumes from where it left off.
A job is stuck and won't move
If processing is interrupted by something like the server's execution time limit, it can appear to stop without even recording an error.
- Check the Last updated column in "Jobs / History." Jobs that haven't moved in over 10 minutes are flagged
- When a job is stuck, the screen shows the state of WP-Cron (whether it's disabled, and when it next runs)
- Each row's "Advance now" button runs a single step immediately, without waiting for WP-Cron. It's also useful for checking whether cron simply isn't running in your environment
If a job keeps stalling at the same point, it automatically stops as a failure, with the cause and a fix written out.
License activation fails
- The key format is
SRB-XXXX-XXXX-XXXX-XXXX. Check for stray spaces before or after it - Activation fails if you've used up your site slots. Deactivate an unused site from My Page
- Activation fails if your server blocks outbound connections
Icons or images don't display
From v2.6.1 onward, icons use SVGs bundled with the plugin. If they don't display, try clearing your browser cache (Ctrl + F5).
Article quality isn't what you expected
- Write specific instructions in Custom Instructions (Custom Instructions and Templates)
- Turn on outline review and fix things at the heading stage
- Try a different optimization type (The 5 optimization types)
- Setting character count to "Leave it to AI" produces a length that fits the search intent
If that doesn't solve it
Contact us via My Page. Including the error text from "Jobs / History" along with your WordPress and PHP versions helps us find the cause faster.