Search Atlas Help Center
Troubleshooting

πŸ› οΈ Fixing 500 Errors When Connecting the WordPress Plugin

Camilo Aponte

Camilo Aponte

Last updated on Nov 6, 2026

πŸ” What This Error Means

When you click Connect to Search Atlas inside the WordPress plugin, a popup opens to complete authentication. A 500 Internal Server Error means your WordPress site could not process the connection request. Because the authentication never finishes, WordPress keeps waiting and eventually times out. This is almost always caused by a server-side setting on your WordPress installation, not by your Search Atlas account.

⚠️ Common Causes

  • Outdated plugin version: An old version of the Search Atlas plugin may not connect correctly.
  • PHP memory limits: Low memory or execution-time limits can stop the request mid-way.
  • Security plugins or firewalls: Tools like Wordfence, or a Web Application Firewall, can block the authentication call.
  • Conflicting plugins or themes: Another plugin may interfere with the connection request.
  • Server permissions or REST API blocks: Some hosts restrict the WordPress REST API, which the connection relies on.

πŸ› οΈ Step-by-Step Fix

Work through these steps in order. Most connections succeed after the first two or three.

  1. Update the plugin: In your WordPress dashboard, go to Plugins and update the Search Atlas plugin to the latest version. Then try connecting again.
  2. Clear your cache: Clear both your WordPress caching plugin and your browser cache, then reload the page before reconnecting.
  3. Increase PHP limits: Ask your hosting provider to raise the PHP memory limit to at least 256MB and the maximum execution time to 300 seconds.
  4. Temporarily disable security tools: Pause any firewall or security plugin, attempt the connection, then re-enable the tool once connected.
  5. Check the REST API: Confirm your host allows the WordPress REST API. If it is blocked, contact your host to enable it.
  6. Test for conflicts: Temporarily switch to a default WordPress theme and disable other plugins, then try connecting. If it works, re-enable items one at a time to find the conflict.

πŸ” Completing the Connection

After applying a fix, return to the plugin and click Connect to Search Atlas again. When the popup opens, log in with your Search Atlas credentials and approve the connection. A confirmation message will appear once your site is linked successfully.

πŸ’‘ Tips to Prevent Future Errors

  • Keep the Search Atlas plugin, WordPress core, and PHP up to date.
  • Use a supported PHP version (8.0 or higher is recommended).
  • Add Search Atlas to your firewall or security plugin allowlist.
  • Avoid connecting while large background tasks, such as backups, are running..

Was this article helpful?