V2 Troubleshooting Guide
Troubleshoot the current V2 workflow without bypassing safety controls.
License or domain will not connect
Open AI Snippets PRO → Settings & Connection. Confirm the key was pasted exactly, the current domain is correct, and the site limit has not been reached. If the site was explicitly released/disconnected, use the explicit reconnect flow; an old installation should not silently re-bind itself.
The wrong SEO provider is shown
Check the provider compatibility section. If multiple supported SEO plugins are active, resolve that ambiguity before applying changes. Native WordPress is intentionally read-only.
Expert Review is unavailable or the balance looks wrong
Check the Expert Review balance/reset information in Settings & Connection. Expert Review capacity is separate from deterministic audits and any other AI-assisted allowance. Failed provider/system requests should not be treated as completed billable reviews.
The SaaS or AI provider is temporarily unavailable
Hosted/AI actions may be unavailable, but the product is designed so deterministic local audit/history workflows remain useful where applicable. Retry the hosted action after service connectivity is restored.
Search Console is disconnected, stale, or failed
Open the Search Console screen and review the connection/freshness state. Reconnect if required. Never paste OAuth tokens into support messages or screenshots.
Apply is blocked
This is usually a safety condition, not a bug. Common reasons include stale source evidence, provider conflict, changed content, unsupported ownership, missing approval, or a target that no longer matches the reviewed state. Re-run/review the evidence rather than bypassing the block.
Live verification does not match the stored change
Clear relevant WordPress/server/CDN caches and run Verify Live again. If the public page still differs, inspect the active SEO provider and cache/output ownership before attempting another write.
Undo is not available
Undo appears only for supported execution paths with a restorable prior state. Do not manually assume an undo exists for observation-only fields or unsupported writes.
A report is marked partial
A partial report means required evidence is incomplete or stale. Refresh the relevant evidence before presenting the report as complete client proof.
My Sites shows a stale or disconnected site
Open that site's WordPress admin and restore the intended connection/heartbeat state. A stale/disconnected site should not be treated as current/healthy simply because an older portfolio summary exists.
I want to remove data
Cloud workspace deletion and WordPress uninstall are separate from billing cancellation. Export supported cloud data before destructive actions. Normal plugin uninstall preserves local workflow/history by default; an administrator can explicitly opt into permanent removal of AI Snippets PRO-owned local tables/meta. Deactivation does not wipe history.
Still stuck?
Email support@aisnippetspro.com with the page URL, what you expected, what happened, and a screenshot that does not expose license keys, OAuth tokens, passwords, or other secrets.