## **🔍 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..