🛠️ What this article covers
Agency customers sometimes add clients to the dashboard without trouble, then hit errors or a stuck screen when installing the white-label plugin. This article walks through the checks that clear most of those blocks.
✅ Before you install
Confirm these items in Search Atlas before you upload or activate the plugin on the client site:
- The client is already created in your agency dashboard and is not archived or paused.
- White-label settings are saved, including your brand name and any required logo or domain fields.
- You downloaded the plugin package from the current white-label or plugin screen, not an older file from email or a previous project.
- The WordPress site uses a supported PHP version, has a working admin login, and is not in maintenance mode.
- Your user role on that site can install and activate plugins.
🚀 Install the plugin
- In Search Atlas, open the client, then open the white-label plugin area and download a fresh plugin file.
- In WordPress, go to Plugins, choose Add New, then Upload Plugin.
- Select the file you just downloaded and choose Install Now.
- After install finishes, choose Activate. Do not rename the plugin folder before upload.
- Open the plugin settings on the site and connect it with the key, token, or connect button shown for that same client in Search Atlas.
- Return to the client in your dashboard and refresh the page to confirm the site shows as connected.
Adding a client to the dashboard and connecting the plugin are separate steps. A client can exist in the dashboard before the plugin is installed.
⚠️ Clear common errors and blocks
- Upload failed or package could not be installed: Download the file again. Make sure the upload is the original archive and that WordPress upload limits and folder permissions allow plugin installs.
- Plugin installed but the connect screen will not finish: Use the credentials for this client only. Remove extra spaces when pasting a key, then save and refresh both WordPress and Search Atlas.
- Stuck on the same screen: Hard-refresh the browser, try a private window, and disable aggressive ad blockers for the Search Atlas and WordPress admin pages. A cached dashboard page often keeps showing an old error.
- Security or firewall block: Temporarily allow the plugin upload and admin-ajax requests in the host firewall, Wordfence, Sucuri, or a similar tool, then retry the install and connection.
- Conflict with another plugin: Deactivate other SEO, cache, or security plugins one at a time, connect the white-label plugin, then turn the others back on.
- Wrong site connected: Disconnect the plugin, confirm the domain on the client record matches the live WordPress address, and connect again.
- Works for old clients but not new ones: Open white-label settings and the new client record again. Save them, download a new package, and repeat the install on the new site only.
🔍 If the screen still will not move
Capture the exact message on the screen, the client domain, and whether the failure happens during upload, activation, or connection. Also note any recent host, DNS, or security changes. Those details make the next check much faster.
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.