User documentation

Troubleshooting

OAuth redirect mismatch

Copy the callback URL from the plugin setup screen and add it exactly to the Google OAuth client. Watch for missing trailing slashes, wrong domains, or staging/live mismatches.

No Search Console data

Confirm the selected Google account has access to the property and that the property format matches Search Console.

Too many low-value opportunities

Increase the minimum-click threshold and use ignored URL patterns for tag archives, private paths, or tracking URLs.

Rate limits or temporary API errors

The plugin includes retry/backoff behavior. Wait a few minutes, reduce scan scope, then rerun the scan.

Emails or webhooks are not sending

Check WordPress mail delivery, recipient formatting, HTTPS webhook URLs, and the minimum score threshold for notifications.