Docs / Troubleshooting · Get indexed by AI
Troubleshooting
Error code → fix map + recurring issues and how to diagnose them.
Error code → fix map
| Error code | HTTP | What to do |
|---|---|---|
| INVALID_LICENSE_KEY | 401 | Verify you copied the key correctly. If lost, request a reissue from the dashboard. |
| LICENSE_SUSPENDED | 403 | License suspended by the admin (abuse or by request). Contact support@geocite22.com. |
| LICENSE_EXPIRED | 403 | Subscription expired. Update the payment method from the Customer Portal. |
| LICENSE_REVOKED | 403 | Subscription canceled or revoked. Subscribe again from /pricing. |
| SITE_LIMIT_EXCEEDED | 403 | Reached the plan’s site cap. Deactivate a site from /dashboard/sites or upgrade. |
| TIER_NOT_ALLOWED | 403 | Endpoint only available on Premium (e.g. /ai/generate). Upgrade or use your own BYOK API key. |
| INSUFFICIENT_CREDITS | 402 | Insufficient credit balance. Buy a top-up or wait for the monthly allocation. |
| RATE_LIMIT_EXCEEDED | 429 | Rate limit 60/min or 600/h exceeded. Implement backoff in the plugin (the plugin does it natively). |
| IDEMPOTENCY_CONFLICT | 409 | Same idempotency_key with a different payload. The plugin regenerates the key on every attempt. |
| PAYLOAD_TOO_LARGE | 413 | post_content over 60K chars. Reduce the content or use a model with a larger context. |
| AI_PROVIDERS_UNAVAILABLE | 503 | All providers in temporary error. Retry after retry_after_seconds. |
| AI_TOOL_USE_MALFORMED | 502 | Provider responded in an unexpected format. The plugin should retry with an alternative provider. |
Recurring issues
The plugin says "License not recognized"
Check that you pasted the entire key including the GC22- prefix (no spaces, no missing dashes). If the key is correct and the error persists, it may have been revoked or reissued: ask the customer (or yourself) for the current key from the dashboard.
JSON-LD doesn't show up in <head>
Verify that another SEO plugin (Yoast, RankMath) isn't stripping custom schemas. From the plugin panel, Diagnostics tab, you'll find the debug of the JSON-LD payload emitted for the current post.
Slow AI generation (> 30s)
Normal with long posts and Opus/GPT-4o. Consider GPT-4o-mini or Gemini Flash for faster generations. On Premium, the ProviderRouter can be configured to prefer faster models.
Voucher "not redeemable" but the code is correct
Check: do you have an active Premium license? Vouchers are reserved for the Premium tier. If yes, verify the expiry date and usage limit. If the code is multi-use but exhausted, request a personal voucher at support@geocite22.com.
Still stuck?
Write to support@geocite22.com with: license key_prefix (first 4 blocks), site URL, received error code, request payload if available.