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

# White-label the console and the widget

> Present MITHUNAI under your own name, logo, colours and links, on the console your team uses and the website widget your visitors see, with no rebuild.

Each organisation can present MITHUNAI under its own brand. Your branding applies to the console your team uses and to the [website widget](/channels/widget) your visitors see, without a rebuild or a new snippet.

Only Owners and Administrators can change branding. Every member sees it.

## What you can set

| Area         | Settings                                                                                                                |
| ------------ | ----------------------------------------------------------------------------------------------------------------------- |
| **Identity** | Product name, short name, company name, legal company name, tagline                                                     |
| **Assets**   | Logo for light and dark themes, logo mark, favicon, social sharing image                                                |
| **Theme**    | Colours for light and dark mode, fonts, base text size, corner radius, default appearance (`light`, `dark` or `system`) |
| **Links**    | Documentation, support, terms and privacy URLs, and a copyright notice                                                  |
| **Surfaces** | Whether the console shows the logo and a "powered by" line, and whether the widget shows branding                       |

Anything you do not set uses the platform default, so you can start with just a name and a logo.

## Change branding in the console

1. Open **Settings** and find the branding section.
2. Edit the fields you want to override, such as company name, logos, favicon and primary colour.
3. Save. The console updates straight away, and the widget picks up the change on its next load.

To return to the defaults, reset branding from the same section.

## Change branding with the API

Read the current branding, edit it and send it back. Saving replaces the whole set of overrides, so always start from what you last read:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
# 1. Read. Note the revision.
curl "$MITHUNAI_URL/arukz/api/v1/branding" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY"

# 2. Replace, sending that revision.
curl --request PUT "$MITHUNAI_URL/arukz/api/v1/branding" \
  --header "Authorization: Bearer $MITHUNAI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "revision": 3,
    "layer": {
      "identity": { "productName": "Acme Answers", "companyName": "Acme" },
      "assets": { "logoLight": "https://cdn.acme.example/logo.svg" },
      "theme": { "modeDefault": "system" }
    }
  }'
```

If someone else saved branding after your read, the request is refused with `409 conflict` and nothing changes. Read again and retry. See [Replace branding](/api-reference/branding/replace-branding) for every field.

## Rules for values

* **Links and hosted assets** must use `https://`.
* **Inline images** can be embedded as base64 `data:` URIs in SVG, PNG, JPEG, WebP, GIF or ICO format. The whole request is limited to 256 KiB, so host large images instead.
* **Colours** must be hex (`#B83E0E`) or `rgb()`, `rgba()`, `hsl()` or `hsla()`. Named colours such as `red` are refused.
* **Text fields** hold 1 to 120 characters.

These rules exist because branding values reach every page that renders your brand; a value outside them is refused rather than escaped.

## What visitors can see

Identity, assets, theme and surface settings are public: the widget needs them to render on your website. Your documentation, support and legal links are not sent to the widget.

## Attribution notices

Some third-party attribution notices are part of the product and are not branding settings. They cannot be changed or removed through branding.

## Where branding shows

The brand you set here renders on the console your team signs in to and on the [website widget](/channels/widget) your visitors see. To build your own settings screen over it, [Get branding settings](/api-reference/branding/get-branding-settings) returns the value limits alongside the current overrides, and [Reset branding](/api-reference/branding/reset-branding) clears the whole layer in one step.