> ## Documentation Index
> Fetch the complete documentation index at: https://docs.layest.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspace Branding: Logo, Colors, and Custom Domain

> Customize your Layest workspace with your company logo, brand colors, and custom domain. Available on Pro and Enterprise plans only.

Workspace branding lets you replace Layest's default visual identity with your own, so every agent-facing interface and outbound email reflects your company rather than the underlying platform. Branding settings cover your workspace logo, primary color scheme, custom domain, and email sender name — giving you a seamless white-label experience for your team and end users.

<Warning>
  Branding features are available on **Pro and Enterprise plans only**. If you are on the Free plan, the branding settings page is visible but all fields are locked. [Upgrade your plan](/billing/upgrade-plans) to unlock branding customization.
</Warning>

## Accessing Branding Settings

1. Click your workspace name in the top-left corner.
2. Select **Settings** from the dropdown.
3. Click **Branding** in the left settings navigation.

## Uploading a Workspace Logo

Your workspace logo appears in the top navigation bar, on agent-facing chat interfaces, and in outbound emails generated by your agents.

1. In the **Logo** section, click **Upload Logo**.
2. Select a PNG, JPG, or SVG file from your device. Recommended size: **200 × 60 px** or larger at a 3:1 aspect ratio. Maximum file size: **2 MB**.
3. Use the crop tool to adjust framing if needed.
4. Click **Save Logo**.

For the best results across light and dark backgrounds, upload an SVG with a transparent background. You can optionally upload separate **Light Mode** and **Dark Mode** logo variants using the toggle in the logo section.

## Setting Brand Colors

Layest applies your brand color to buttons, active states, highlights, and links throughout agent-facing interfaces.

1. In the **Brand Colors** section, click the **Primary Color** swatch.
2. Enter a hex code directly (for example, `#4F46E5`) or use the color picker.
3. A live preview on the right updates as you adjust the color.
4. Click **Save Colors** when you are satisfied.

<Info>
  Layest automatically calculates accessible contrast ratios for text overlaid on your brand color. If your chosen color results in a contrast ratio below WCAG AA standards, a warning is shown and you are prompted to select a darker or lighter shade.
</Info>

## Configuring a Custom Domain

A custom domain replaces the default `*.layest.ai` URL for your agent-facing interfaces with your own subdomain, such as `agents.yourcompany.com`.

<Steps>
  <Step title="Enter Your Custom Domain">
    In the **Custom Domain** section, type the subdomain you want to use (for example, `agents.yourcompany.com`) and click **Add Domain**.
  </Step>

  <Step title="Copy the DNS Records">
    Layest generates two DNS records you need to add: a **CNAME** record pointing your subdomain to Layest's edge network, and a **TXT** record for domain ownership verification. Copy both values.
  </Step>

  <Step title="Add Records in Your DNS Provider">
    Log in to your DNS provider (Cloudflare, Route 53, GoDaddy, etc.) and create the CNAME and TXT records exactly as shown. Do not proxy the CNAME record through Cloudflare's orange cloud — set it to **DNS only** (grey cloud).
  </Step>

  <Step title="Verify the Domain">
    Return to **Settings → Branding** and click **Verify Domain**. Layest checks for both DNS records. If verification succeeds, the domain status changes to **Active** and a free TLS certificate is provisioned automatically.
  </Step>

  <Step title="Set as Default">
    Click **Set as Default** to make the custom domain the primary URL for all your agent interfaces. The old `*.layest.ai` URL continues to redirect to your custom domain.
  </Step>
</Steps>

<Note>
  DNS changes can take up to 48 hours to propagate globally, though most providers apply them within 5–30 minutes. If verification fails after an hour, double-check that both records were entered without typos and that no conflicting records exist for the same subdomain.
</Note>

## Email Branding

When your agents send emails (for example, notifications, summaries, or agent-generated messages), you can customize the sender name that appears in the recipient's inbox.

1. In the **Email Branding** section, enter the **Sender Name** you want recipients to see (for example, `Acme AI Assistant`).
2. Optionally enter a **Reply-To Address** so replies land in your own inbox rather than a no-reply address.
3. Click **Save Email Settings**.

<Tip>
  For higher email deliverability and to avoid spam filters, Enterprise customers can configure a custom sending domain with SPF, DKIM, and DMARC records. Contact your Customer Success Manager to set this up.
</Tip>