## 🔍 Overview Search Atlas allows agencies to present a fully branded experience to clients through a white-label domain. This article explains how to log in to your white-label portal, why you may see an invitation prompt, and how to correctly share or embed client reports using your agency domain rather than a Search Atlas URL. ## 🚪 Logging In to Your White-Label Domain Your white-label domain is a custom URL that your agency configured during setup (for example, **reports.youragency.com**). When you or a client visits this URL, you should land on a branded login screen — not a Search Atlas page. If you are prompted with an **invitation required** message when visiting your white-label domain, this is usually caused by one of the following: - The user account has not yet been added to the white-label workspace. An agency admin must send an invitation from within the platform before that user can log in. - The white-label domain setup is incomplete or the DNS configuration has not fully propagated. DNS changes can take up to 48 hours to resolve globally. - The user is trying to log in with a Google account. Google OAuth for white-label tenants is currently handled separately from the main Search Atlas login. Until this is fully split, use your **email and password** to log in to the white-label portal instead of the Google sign-in button. To invite a client or team member to your white-label workspace, log in to Search Atlas, navigate to your white-label settings, and send an invitation from there. The invited user will receive an email with a direct link to set up their access. ## 📊 Finding and Sharing the Correct Report URL When you build a client report in Search Atlas and copy the share or iframe link, the URL should reflect your white-label domain — not **dashboard.searchatlas.com**. If you are seeing a Search Atlas URL instead of your agency domain in the share link, this is a known issue currently in development and will be resolved in an upcoming release. In the meantime, use the following workaround to generate the correct white-label report URL: 1. Go to **Left sidebar → Reports** (or navigate to **/report-builder/projects-list**). 2. Open the report you want to share with a client. 3. Copy the URL shown in your browser's address bar. 4. Replace the **dashboard.searchatlas.com** portion of the URL with your white-label domain (for example, change **https://dashboard.searchatlas.com/report-builder/...** to **https://reports.youragency.com/report-builder/...**). 5. Paste the updated URL into your iframe embed code or share it directly with your client. This manually adjusted URL will load the report through your branded portal as long as the client has been invited to and has access to your white-label workspace. ## ⚙️ Common Issues and Quick Fixes - **Redirected to a billing or choose-plan page:** This was a known bug and has been resolved. If you still experience this, clear your browser cache and cookies, then try logging in again. - **ERR\_TOO\_MANY\_REDIRECTS on your white-label URL:** This can occur if there is a conflict in your domain's redirect rules. Check that your DNS and SSL settings are correctly configured with no conflicting redirects. Contact your domain host if the issue persists at the DNS level. - **White-label domain works but OTTO pixel is not loading:** This was a known issue tied to redirect loops and has been resolved. If you still see OTTO-related issues on your white-label domain, please reach out via the chat widget. - **Client sees a Search Atlas branded page instead of your agency branding:** Confirm that the URL your client is using matches your white-label domain exactly, including the correct subdomain (e.g., **reports.** vs **app.**). ## ✅ Best Practices for White-Label Access - Always invite clients through the white-label workspace settings before sharing any report links. Uninvited users will be blocked at login. - Instruct clients to bookmark the white-label login URL and use their email and password rather than Google sign-in until Google OAuth is fully supported for white-label tenants. - When building iframe embeds for client dashboards, manually verify that the embedded URL uses your agency domain and test it in an incognito window before sending to clients. - If you manage multiple clients, confirm that each client is invited only to their own workspace to prevent cross-client data visibility. ## 💬 Need More Help? If you need further assistance, open the chat widget in the bottom-right corner of the platform and type **human teammate** to be connected with a member of our team.