Troubleshooting
Most problems come down to an API key, a provider limit or a missing SEO plugin.
Common issues
| Symptom | What to check |
|---|---|
| No supported SEO plugin detected | Existing-page repair needs a writable integration. Install and activate Yoast SEO, Rank Math, All in One SEO, SEOPress or The SEO Framework, then scan again. |
| Scan times out | Lower the existing-page scan batch size. Slower shared hosting needs smaller batches. |
| Suggestions or generation fail | Check the active provider's key, billing, model access and remaining credit. Use the provider test button in Settings, and consider enabling a fallback provider. |
| A model isn't listed | Click Refresh models. Some models need billing enabled or aren't available in your region. |
| Page was saved as a draft instead of publishing | Open the page's Pre-Publish Checklist. The gate held it for a score below 80, a blocking failure, or because the scrubber had to clean the output. |
| Content feels generic | Add real proof, service details, case studies, pricing, local signals and banned phrases, then regenerate as a draft. |
| Template colours don't change | Confirm the template still uses standard ca-* classes and doesn't override colours inline. |
| Scheduled campaigns run late | WP-Cron only fires on site visits. Add a server cron — see Campaigns. |
| A page is reported as an orphan but has links | Links added through some page builders may not be visible to Link Audit. |
| "Licence" or plan feature not available | Check Settings → Licence for status and site slots. See Licensing. |
Getting logs
Enable Diagnostics → debug logging in Settings only when troubleshooting or when support asks. It reveals the Debug Log page with recent plugin and API errors. Turn it off again afterwards.
Contact support
See the support page for how to reach us and what to include.
Last updated: