π Overview
If your Search Atlas WordPress plugin is showing an authentication error, a login screen after a successful sync, or an API key verification failure, this guide walks you through the most common causes and fixes. Follow the steps in order before reaching out to support.
β οΈ Common Symptoms
- Authentication failed or timed out after authorizing the plugin
- The plugin dashboard shows a login page even though sync completed successfully
- The error message: "The API key could not be verified"
- The error message: "authentication credentials not provided" during a diagnostic run β the connection between your site and Search Atlas has broken or was never fully established
- A 500 error appears in the API key authentication popup
π The API Key and Plugin Auth Token Fields Are Locked on Purpose
In current plugin versions, the Search Atlas API Key and Plugin Auth Token fields in the plugin settings do not accept typed or pasted text. The fields are locked by design and are filled in automatically once the connection completes. You do not need to enter anything into them manually.
If authentication is timing out or failing, do not try to type or paste into these fields. Instead, work through the connection checks below. If the connection still fails, contact support with your site URL and plugin version.
π οΈ Step 1 β Confirm Your API Key Is Active
An expired or invalid API key is the most frequent cause of authentication failures.
- Log in to your Search Atlas account.
- Navigate to Settings β API Keys.
- Confirm your key exists and is active. Generate a new key only if the old one is inactive or missing.
You do not paste this key into the WordPress plugin β the plugin fills in its credentials automatically when the connection succeeds (see the section above).
π Step 2 β Re-Authorize the Plugin
Sometimes the plugin loses its connection after a timeout or a platform update. Manually re-authorizing resets the session:
- In your WordPress admin panel, go to Search Atlas β Settings.
- Click Disconnect or Log Out if the option is available.
- Clear any cached credentials by deactivating the plugin, then reactivating it from the Plugins page.
- Complete the authorization flow again β the credential fields fill in automatically when the connection succeeds.
- Wait a minute, then run diagnostics again to see whether the error clears.
π Step 3 β Check for Server or Hosting Conflicts
Some hosting environments block outbound API requests or enforce aggressive caching, which can interrupt authentication. Try the following:
- Disable caching plugins temporarily (e.g., WP Rocket, W3 Total Cache) and attempt authentication again.
- Temporarily deactivate security or firewall plugins and run diagnostics again. If diagnostics pass with those plugins off, re-enable them one at a time to identify the conflict, then adjust that plugin's settings to allow Search Atlas traffic.
- Check your firewall or WAF rules β ensure requests to Search Atlas API endpoints are not blocked. Ask your hosting provider if outbound HTTPS calls are restricted at the server or firewall level.
- Check whether your site's REST API is accessible β if it is disabled or restricted, the plugin will not be able to authenticate.
- Confirm your PHP version is 7.4 or higher, as older versions can cause unexpected failures during API handshakes.
- Increase PHP timeout limits if your server has a very low execution time setting (under 30 seconds). The authentication handshake may time out before completing.
π Step 4 β Update or Reinstall the Plugin
Running an outdated version of the Search Atlas plugin can cause compatibility issues with the current API. To update:
- In your WordPress admin panel, go to Plugins β Installed Plugins.
- Check if an update is available for Search Atlas and click Update Now.
- If no update is available but issues persist, deactivate and delete the plugin, then reinstall the latest version from your Search Atlas account or the WordPress plugin directory.
- After reinstalling, complete the authorization flow again.
π₯οΈ Step 5 β Clear Browser and WordPress Cache
A cached login state can cause the plugin dashboard to show a login page even after a successful sync. This is a display issue, not an authentication failure:
- Clear your WordPress site's cache β including any object cache or page cache β and your browser cache and cookies, then reload the admin panel.
- If you use a caching plugin, purge all cached pages.
- Try opening the plugin in a private or incognito browser window to rule out session conflicts.
β When Everything Looks Correct but Still Fails
If you have completed all the steps above and authentication still fails β especially if a 500 error appears in the authentication popup or regenerating the API key does not resolve the issue β this may indicate a platform-side bug that requires investigation by our engineering team.
If you need further assistance, open the chat widget in the bottom-right corner of the platform and send your message. A member of our support team will reply in the chat.
When you reach out, please share the following to speed up the resolution:
- Your WordPress site URL and Search Atlas account email
- The exact error message or screenshot
- Your WordPress version and PHP version
- Your hosting provider name
- A list of any active security or firewall plugins
- Details of any recent changes to your site or hosting environment
- Steps you have already tried from this guide
Related articles: Fix WordPress MetaSync Plugin Authentication Failures (the MetaSync-branded version of this guide) Β· Fix WordPress Plugin Authentication Timeout Errors Β· Fixing 500 Errors When Connecting the WordPress Plugin