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

# Platform Branding

> Customize the Elementum accent color and organization logos so the workspace matches your brand.

## Overview

Platform Branding lets Organization Administrators customize how Elementum looks for everyone in the organization. Set a shared accent color that carries across primary buttons, links, active states in main and sub navigation, icon hover states, focus states, and the login flow, and add company and login-page logos so the workspace visually reflects your brand.

Branding is especially useful when external collaborators use Elementum — a distinctive accent color and logo help them immediately recognize which customer's organization they're working in and reduce wrong-account mistakes.

## Prerequisites

* **Elementum permissions:** Organization Administrator access.
* **Assets:** A Company Logo used across the platform and a dedicated Login Page Logo displayed on the login screen.
* **Accent colors:** Hex values (or a color picker selection) for both Light Mode and Dark Mode.

## Configure Platform Branding

Platform Branding is managed alongside your organization's other identity settings.

**Where to find it:** **Organization Settings** → **General** → **Platform Branding**.

<Steps>
  <Step title="Open Platform Branding">
    1. Open **Organization Settings** and select **General**.
    2. Scroll to the **Platform Branding** section.
  </Step>

  <Step title="Enable custom branding">
    Check **Enable Custom Branding** to turn on your organization's custom accent color and login-page logo.

    Custom branding is off by default; toggling it on activates the accent color, Login Page Logo, and Live Preview controls described below.
  </Step>

  <Step title="Upload logos">
    Upload the two logos used across Elementum:

    * **Company Logo** — Used across the platform, including the organization icon in the main navigation. The Company Logo is managed in **General Settings** just above the Platform Branding section and is reused everywhere your organization's logo appears in-app.
    * **Login Page Logo** — A dedicated logo displayed above the email field on the login screen.
  </Step>

  <Step title="Set accent colors">
    Set the **Accent Color** for both **Light Mode** and **Dark Mode** so users see a consistent look regardless of their theme.

    <Tip>
      Choose colors with enough contrast against light and dark backgrounds so buttons, links, and focus states stay legible.
    </Tip>
  </Step>

  <Step title="Preview and save">
    Use the **Live Preview** on the right side of the page to confirm how your accent color appears across primary buttons, links, navigation states, and focus states in each theme. Adjust the accent color and logos as needed, then click **Save** when finished.
  </Step>
</Steps>

## Where custom branding appears

When Custom Branding is enabled, the accent color and logos are applied globally so users see a consistent visual identity across:

* Primary buttons
* Links
* Active states in main and sub navigation
* Icon hover states
* Focus states
* The login flow
* The Elementum organization icon

<Note>
  The Company Logo lives in the General Settings section above Platform Branding and is reused throughout the platform. The Login Page Logo only affects the login screen, so you can use different assets for in-app branding and the login page if your visual identity calls for it.
</Note>

## Update or turn off custom branding

* **Update a color or logo:** Return to **Organization Settings** → **General** → **Platform Branding**, change the field, review the update in the Live Preview, and click **Save**.
* **Turn off custom branding:** Uncheck **Enable Custom Branding** and click **Save**. Elementum reverts to the default accent color and logo experience. Uploaded logos remain saved and are reapplied the next time you enable custom branding.

## Best practices

* **Set both themes.** Elementum honors each user's Light Mode or Dark Mode preference, so define an accent color for both modes to avoid falling back to the default in one theme.
* **Match your style guide.** Pick accent colors your team already uses in other tools so Elementum feels like part of your platform.
* **Keep logos current.** Upload updated logos when your brand changes so external collaborators still recognize your organization at a glance.
* **Preview before saving.** Use the Live Preview on the settings page to confirm buttons, links, and focus states remain legible against your accent color before rolling out the change.