🔌 What These Errors Mean
White label plugin install and connection errors mean the client site cannot finish installing the plugin or cannot reach Search Atlas to link the account. Adding clients can still work, because that step does not use the same site install and connection handshake.
✅ Before You Install
- Sign in to the client WordPress site as an administrator.
- Download a fresh white label plugin zip from your Search Atlas account. Do not reuse an older file.
- Match the site URL in Search Atlas to the live address, including HTTPS and www or non-www.
- If a security, firewall, or optimization plugin blocks new plugins or outbound requests, pause it only while you install and connect.
🛠️ Install the Plugin
- In WordPress, open Plugins, then Add New, then Upload Plugin.
- Select the white label zip and choose Install Now.
- When installation finishes, choose Activate.
- Open the plugin settings and connect with the key or connect action from your Search Atlas white label area.
🚫 Fix Common Blocks
- Upload failed or the plugin could not be installed: Download the zip again, confirm it is not corrupted, and retry. If the host rejects the file size, raise the upload limit or install the zip through the host file manager.
- Connection timed out or could not reach Search Atlas: The site must be allowed to make outbound HTTPS requests. Host firewalls, bot protection, and security plugins often block this step.
- Invalid key or unauthorized: Create a new connection key in Search Atlas and paste it with no extra spaces. Use a key for this site only.
- Site already connected: Disconnect the previous property in Search Atlas, or remove the old plugin connection, then connect again.
- White screen or fatal error after activation: Confirm the host PHP and WordPress versions meet current requirements. Deactivate other plugins, activate the white label plugin alone, then turn plugins back on one at a time to find a conflict.
- Older clients connect but new ones fail: Compare hosting, SSL, and security rules. A newer host or a stricter firewall is the most common change.
🔁 Retry the Connection
- Clear the site cache and any host cache.
- Deactivate the white label plugin, then activate it again.
- Save the connection key and wait for the success message before leaving the page.
- Refresh the client in Search Atlas and confirm the site shows as connected.
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.