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. |
| Gemini key check says the key was rejected | Make sure you copied the whole key with no spaces. Or create a new one in Google AI Studio. The key is not saved until you save Settings. |
| Gemini key check says it is rate limited | The key is valid but Google is limiting requests right now. Wait a minute and paste it again, or check your quota in Google AI Studio. |
| Gemini key check could not reach Google | Your host may block outgoing requests. You can still save the key and test it with a real generation. See Getting an API key. |
| Business Profile cannot find my listing | Check the business name and town match your Google listing exactly, or add your website or Maps link. You can also paste your current description to get a comparison. If the listing is still not found, Writrex says so and gives general advice based on the details you entered. See Business Profile. |
| Business Profile text has a wrong detail | Writrex writes text for you to copy and never posts to Google. Check every fact, phone number and service before you paste it into your profile, and correct anything wrong in the form, then run it again. |
| Suggest local facts finds nothing or the wrong place | Check the Target Area is spelled as the place is known, and add the county or region if the name is shared. Open each source and tick only facts you have confirmed. Nothing is added to Local Signals until you click Add ticked facts. See Suggest local facts. |
| Voice Writing does not hear me, or says the browser is not supported | Use Chrome, Edge or Safari (Firefox cannot do speech-to-text), make sure the site uses HTTPS and allow the microphone from the padlock in the address bar. See Voice Writing problems and fixes. |
| Smart Fields asks for nearby areas | Add at least two nearby areas, or tick "This business doesn't serve other nearby areas". It needs a Starter plan or higher. See Smart Fields. |
| 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: