## **🔗 Before you begin**

Make sure you have administrator access to the WordPress site and access to the correct Search Atlas whitelabel dashboard. Confirm that the plugin is installed from the dashboard or the approved plugin package. Remove duplicate or outdated versions before connecting.

## **⚙️ Connect the plugin**

1. Sign in to your whitelabel dashboard.
2. In WordPress, open the plugin's General settings and find the One-Click Authentication section.
3. You don't need to copy a code. Clicking the connect button generates a one-time token automatically and opens the dashboard sign-in in a popup.
4. In WordPress, open Plugins and activate the Search Atlas SEO plugin (it may appear under your whitelabel brand name).
5. Open the plugin settings (General → Connection & Authentication). Don't paste anything: the API key and OTTO UUID are filled in automatically after you authenticate.
6. Click the "Connect to " button. If the plugin is already connected, the button reads "Re-authenticate with ", and if the setup is only partially complete it reads "Complete Authentication Setup".
7. Return to the dashboard and confirm that the website shows as connected.

## **🔐 Fix authentication errors**

A connection failure usually means the sign-in popup was blocked or closed, the 15-minute connect attempt expired, no OTTO project exists for this website's domain on that dashboard, or you signed in to a different whitelabel account than the one managing the site.

- Click the connect button again to start a fresh attempt. It creates a new token each time, with a limit of 10 attempts per 5 minutes.
- Confirm the website's URL in WordPress (domain, subdomain and https/http) matches the project in the dashboard. The one-click token is tied to the site URL, so a mismatch will cause the connection to fail.
- Use the same whitelabel dashboard account that manages the website.
- Deactivate and remove older plugin versions, then install and activate the current version.
- Clear any WordPress caching or security plugin cache before trying again.
- Temporarily check whether a firewall, maintenance mode, or security plugin is blocking the connection.
- Ensure the WordPress site can make outbound connections and that REST API access is not restricted.

## **🌐 Check the website address**

The address in the dashboard must match the address used by WordPress. Check for differences such as **www** versus non-www, HTTP versus HTTPS, a staging domain, or a trailing slash. If the site recently moved or changed domains, disconnect the old entry and create a connection for the current URL.

## **✅ Confirm the connection**

After authentication succeeds, refresh the plugin settings and the whitelabel dashboard. The plugin should show the connected state ("Synced") with the masked API key and the OTTO UUID filled in, and the website should show as active in the dashboard. If you change the domain or switch dashboards, start a fresh connection from the plugin. Each connect attempt is single-use and expires after 15 minutes.

## **💬 Get help**

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.