**Configuration -> Branding** in your admin dashboard.

This is where the white label actually happens. Everything on this screen is
applied the moment you save, across your whole environment, without a deploy and
without us. Your traders never see a Propper logo unless you put one there.

You need the `manage_branding` permission to open it.

The screen has three tabs, in the order your traders meet them: **Global** for
the platform itself, **Login / Register** for the first page they ever see, and
**Status Page** for your public status page.

## Global

### Colours

Start from a preset: blue, green, purple, red, orange, teal, pink or amber. A
preset sets your primary colour for light and dark mode in one click, and that is
enough for most firms.

If you want more control, every surface can be set individually, in light and
dark mode separately:

| Group   | Fields                                                                                           |
| ------- | ------------------------------------------------------------------------------------------------ |
| General | Background, Text, Card Background, Card Text, Primary, Primary Text, Accent / Hover, Accent Text |
| Sidebar | Background, Text, Active, Active Text, Hover, Hover Text, Borders                                |

You do not have to fill all of them. When you set **Primary** and leave the rest
empty, the platform derives the sidebar active colour, the accent, the hover
tints and the focus ring from it. Anything you set explicitly always wins over
what was derived.

Colours are hex, either `#rrggbb` or `#rrggbbaa` if you want transparency. The
live preview next to the fields shows a real trader dashboard in your colours,
and you can flip it between light and dark to check both before saving.

:::tip Check dark mode
Traders choose their own light or dark mode, so both get used. The preview
toggle is there so you do not find out from a support ticket.
:::

### Logos and favicon

Three images, all optional:

- **Light mode logo**, used on light backgrounds.
- **Dark mode logo**, used on dark backgrounds. Upload both, or the same logo
  will sit on a background it was not designed for.
- **Favicon**, the icon in the browser tab. Upload any image and we convert it
  to a multi-resolution ICO for you.

**Border radius** rounds the corners of your logo images, from 0 to 50. Useful
when your logo is a square mark and the surrounding UI is rounded.

SVG or PNG with a transparent background gives the best result.

## Login / Register

The login and register pages are the first thing a prospective trader sees, so
they get their own branding beyond colours and a logo.

- **Heading**, up to 100 characters.
- **Subheading**, up to 300 characters.
- **Background image**, up to 5 MB.
- **Feature bullets**, up to five, each with an optional icon, a title of up to
  50 characters and a description of up to 150. Use them for what makes your
  firm worth signing up with.

A bullet without both a title and a description is dropped on save rather than
shown half empty.

The preview here switches between the login and the register page, and between
light and dark, because the two pages use the same settings but not the same
layout.

## Status Page

Your public status page can carry its own branding, separate from the platform.
That is deliberate: it lives on `status.yourdomain.com` and people often reach it
when the platform itself is unreachable.

:::warning This tab is locked until your status domain is verified
The fields only unlock once the status subdomain has passed DNS verification on
**Configuration -> Domain**. This is enforced on the server as well, so status
branding sent before verification is ignored rather than stored.
:::

Once unlocked you can set:

- A **logo**, **dark logo** and **favicon** for the status page alone.
- A **heading** (100 characters) and **description** (300 characters).
- An **accent colour**, plus a colour for each of the four status levels:
  operational, degraded, partial outage and major outage.
- A **support link** with your own label, so someone looking at a red status page
  has somewhere to go.

## Limits

| Field                           | Limit                            |
| ------------------------------- | -------------------------------- |
| Logo, dark logo                 | 2 MB, any image format           |
| Favicon                         | 2 MB, ICO, PNG, SVG, JPG or WebP |
| Login background                | 5 MB, any image format           |
| Status logo, dark logo, favicon | 2 MB, same formats as above      |
| Colours                         | Hex, `#rrggbb` or `#rrggbbaa`    |
| Logo border radius              | 0 to 50                          |
| Login heading / subheading      | 100 / 300 characters             |
| Login feature bullets           | 5, each 50 / 150 characters      |
| Status heading / description    | 100 / 300 characters             |
| Status support label            | 50 characters                    |

## Things worth knowing

**Removing an image deletes it.** Hitting remove and saving deletes the file from
storage, it is not archived. Keep your own copy of your logo.

**Changes are live immediately.** There is no draft and no publish step. What you
save is what the next trader who loads a page sees.

**Uploaded images are resized.** Logos are fitted to 800 by 800 and the login
background to 1920 by 1080. Upload something at least that size for a sharp
result.

**Colours are yours, layout is not.** This screen changes how the platform looks,
not how it is arranged. The underlying design comes from the skin selected for
your firm; ask us if you want a different one.

Related: [API keys](/docs/platform/admin/api-keys) for programmatic access, and
[Features](/docs/platform/features) for what else the platform does.