<!-- Markdown version of https://writrex.com/docs-troubleshooting/ — last updated 2026-09-19 -->

# 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](https://writrex.com/docs-campaigns/#wp-cron). |
| 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](https://writrex.com/docs-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](https://writrex.com/support/) for how to reach us and what to include.
