🔍 What Does "Unengaged" Mean?
When your Search Atlas WordPress plugin shows an Unengaged status, it means the plugin is installed on your site but has not successfully established an active, verified connection with your Search Atlas account. This is different from a failed installation — the plugin is present, but the handshake between your site and Search Atlas is incomplete.
⚠️ Common Causes of the Unengaged Status
- Incorrect API key or token: The credentials entered during setup do not match your Search Atlas account.
- Plugin version mismatch: An outdated version of the plugin may not communicate correctly with the Search Atlas platform.
- Caching interference: Server-side or plugin-based caches can block the authentication request from completing.
- Conflicting plugins: Security plugins, firewall plugins, or other SEO tools can intercept or block outbound API calls.
- PHP or server restrictions: Some hosting environments restrict external HTTP requests, preventing the plugin from reaching Search Atlas servers.
- WordPress site URL mismatch: If your WordPress address and site address settings differ, authentication may fail silently.
🛠️ Step-by-Step Troubleshooting
- Verify your API credentials. In Search Atlas, go to Settings > Integrations > WordPress and copy your API key. In your WordPress dashboard, navigate to Search Atlas Plugin > Settings, paste the key, and save. Double-check there are no extra spaces before or after the key.
- Update the plugin. Go to WordPress Dashboard > Plugins > Installed Plugins, find Search Atlas, and click Update if a newer version is available. Always use the latest version to ensure compatibility.
- Deactivate, then reactivate the plugin. In Installed Plugins, click Deactivate next to Search Atlas, wait 10 seconds, then click Activate again. Re-enter your API key and save.
- Clear all caches. Purge your WordPress caching plugin (e.g., WP Rocket, W3 Total Cache, LiteSpeed Cache) and clear your hosting provider's server cache. Then retry the connection.
- Check for plugin conflicts. Temporarily deactivate security or firewall plugins such as Wordfence, iThemes Security, or All In One WP Security. Attempt to authenticate again. If it works, whitelist the Search Atlas domain in your security plugin settings and re-enable it.
- Confirm your WordPress URL settings. In WordPress Dashboard > Settings > General, ensure the WordPress Address (URL) and Site Address (URL) fields are identical and use the correct protocol (https:// if SSL is enabled).
- Test external HTTP requests. Ask your hosting provider whether outbound HTTP requests to external APIs are allowed. Some managed hosting plans restrict this by default. Request that they whitelist Search Atlas API endpoints if needed.
- Reinstall the plugin cleanly. Deactivate and delete the plugin, then download the latest version from Search Atlas and reinstall it via Plugins > Add New > Upload Plugin. Re-enter your credentials after reinstallation.
✅ How to Confirm the Plugin Is Now Engaged
After completing the steps above, return to your Search Atlas dashboard and navigate to Settings > Integrations > WordPress. Your site should now display a green Engaged status. If you see this, the connection is active and data will begin syncing automatically.
💡 Tips to Prevent Future Issues
- Always keep the Search Atlas plugin updated to the latest version.
- After any major WordPress core update, re-check the plugin status in Search Atlas.
- Avoid using multiple SEO plugins simultaneously, as they can conflict with each other.
- If you migrate your WordPress site to a new domain or host, re-authenticate the plugin immediately after the move.
🆘 Still Showing Unengaged?
If you have followed all the steps above and the plugin still shows an Unengaged status or persistent errors, our team is ready to help. 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.