🔍 Overview
When connecting your WordPress site to Search Atlas using the MetaSync plugin, you may encounter an Authentication Failed error or a blank/spinning popup that prevents the connection from completing. This article walks you through the most common causes and how to fix them.
⚙️ Before You Begin
Make sure you have the following ready:
- Admin access to your WordPress dashboard
- Admin access to your Search Atlas account
- The latest version of the MetaSync plugin installed and activated
🛠️ Step 1 — Verify Your OTTO SEO Setup
The MetaSync plugin requires an active OTTO SEO setup linked to your site before authentication can complete. If OTTO has not been configured, the plugin cannot verify your account.
- Log in to your Search Atlas account.
- Navigate to OTTO SEO from the main menu.
- Confirm that your WordPress site's domain is listed and that OTTO has been activated for it.
- If your site is not listed, add it and complete the OTTO setup before proceeding.
🔑 Step 2 — Regenerate Your API Key
A corrupted or outdated API key is a common cause of authentication failures. Regenerating the key often resolves the issue.
- In Search Atlas, go to Settings → API Keys (or your account/profile settings).
- Locate your existing API key and select Regenerate or Create New Key.
- Copy the new API key immediately — it will only be shown once.
- In your WordPress dashboard, go to Search Atlas → Settings.
- Paste the new API key into the API Key field and save.
- Click Connect and wait for the authentication popup to complete.
🌐 Step 3 — Check for a 500 Error in the Authentication Popup
If the authentication popup returns a 500 error instead of a success message, this indicates a server-side verification issue. Try the following:
- Clear your browser cache and cookies, then retry the connection in a fresh browser window.
- Disable any browser extensions (especially ad blockers or privacy tools) that may interfere with the popup.
- Try a different browser to rule out a local browser issue.
- Ensure your WordPress site is publicly accessible and not behind a maintenance mode plugin or firewall that blocks external API requests.
🔒 Step 4 — Confirm Your Site Allows External API Requests
The MetaSync plugin communicates with Search Atlas servers to verify your API key. If your hosting environment blocks outbound requests, authentication will fail.
- Check with your hosting provider that outbound HTTPS requests on port 443 are not blocked.
- If you use a security plugin (e.g., Wordfence, iThemes Security), temporarily disable it and retry the connection.
- If you use a firewall or CDN (e.g., Cloudflare), make sure Search Atlas API endpoints are not being blocked or rate-limited.
- Ensure your WordPress site has a valid SSL certificate — authentication will not complete over HTTP.
🔄 Step 5 — Reinstall the MetaSync Plugin
If none of the steps above resolve the issue, reinstalling the plugin clears any corrupted plugin files that may be causing the failure.
- In your WordPress dashboard, go to Plugins → Installed Plugins.
- Deactivate and then Delete the MetaSync plugin.
- Download the latest version of the MetaSync plugin from your Search Atlas account or the WordPress plugin repository.
- Upload and activate the plugin.
- Re-enter your API key and attempt the connection again.
✅ Confirming a Successful Connection
A successful connection will display a confirmation message inside the MetaSync plugin settings page, and your site will appear as connected in your Search Atlas dashboard. Once connected, data sync between WordPress and Search Atlas will begin automatically.
💬 Still Need Help?
If you have followed all the steps above and are still seeing an authentication error, If you need further assistance, open the chat widget in the bottom-right corner of the platform and type human teammate to be connected with a member of our team.
When reaching out, please share the following to help us investigate faster:
- Your WordPress site URL
- The exact error message or screenshot you are seeing
- Your WordPress version and MetaSync plugin version
- Any security plugins or firewall tools active on your site