## **🖼️ Overview**

Uploading your logo to Search Atlas personalises your workspace and keeps your branding consistent across reports and dashboards. If your logo is not loading or the upload fails, this guide walks you through the requirements and the most effective fixes.

## **📐 Logo File Requirements**

Before uploading, make sure your file meets all of the following requirements:

- **Accepted formats:** PNG, JPG, JPEG, SVG, or WebP
- **Maximum file size:** 2 MB
- **Recommended dimensions:** 200 × 80 px (landscape orientation works best)
- **Background:** Transparent PNG files are recommended for the cleanest display
- **Colour mode:** RGB (not CMYK — CMYK files may fail to upload or display incorrectly)

Files that exceed the size limit or use an unsupported format will be silently rejected or fail to display, so confirming these details first saves time.

## **🛠️ Step-by-Step Troubleshooting**

Work through the steps below in order. Most logo upload issues are resolved within the first two or three steps.

1. **Check the file size and format.** Open your file manager, right-click the image, and select **Properties** (Windows) or **Get Info** (Mac). Confirm the file is under 2 MB and is one of the accepted formats listed above.
2. **Resize or compress the image.** If the file is too large, use a free tool such as Squoosh, TinyPNG, or Adobe Express to compress it below 2 MB without losing visible quality. Re-save as PNG or JPG before trying again.
3. **Convert CMYK to RGB.** If your logo was exported from a print workflow, it may be in CMYK colour mode. Open it in your image editor and convert the colour mode to RGB, then re-export.
4. **Rename the file.** Remove any special characters, spaces, or accented letters from the filename. Use only letters, numbers, hyphens, and underscores (e.g. **company-logo.png**).
5. **Clear your browser cache.** A cached version of the page can make it appear that the upload failed even when it succeeded. Press **Ctrl + Shift + R** (Windows) or **Cmd + Shift + R** (Mac) to hard-refresh, then check the logo again.
6. **Try a different browser.** Test the upload in a second browser (Chrome, Firefox, or Edge) to rule out a browser extension or local setting causing the issue.
7. **Disable browser extensions.** Ad blockers and privacy extensions occasionally intercept file upload requests. Temporarily disable all extensions, then attempt the upload again.
8. **Check your internet connection.** Large file uploads can time out on slow or unstable connections. Switch to a stable network and retry.

## **📤 How to Upload Your Logo**

Once your file meets all requirements, follow these steps to upload your logo inside Search Atlas:

1. Log in to your Search Atlas account.
2. Click your **avatar** in the top-right corner of the platform.
3. Select **White Label Setup** from the dropdown menu.
4. Navigate to **Settings** (Logo).
5. Click **Upload Agency Logo**, select your prepared file, and confirm.
6. Hard-refresh the page to see the updated logo displayed across your account.

## **⚠️ Still Not Working?**

If you have followed every step above and the logo still will not load, there may be an account-level issue that requires manual review by our team. 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.

When you reach out, please have the following ready to speed up the resolution:

- The logo filename and file size
- The file format (PNG, JPG, SVG, etc.)
- A screenshot of any error message displayed during the upload
- The browser and operating system you are using