Skip to main content

Customize UI branding

Customize the Admin UI logo and favicon.

Via the UI​

  1. Open Settings → UI Theme.
  2. Paste a hosted image URL into Logo URL. Optionally set Custom Logo URL (dark mode).
  3. Click Save Changes. The logo appears in the dashboard sidebar and login page.

Set Custom Logo URL (dark mode) or UI_LOGO_PATH_DARK for artwork designed for a dark background. If it is unset or cannot be loaded, dark mode reuses the light logo. Setting only a dark logo leaves light mode on the default LiteLLM logo.

Via the API​

curl -X PATCH 'http://localhost:4000/update/ui_theme_settings' \
-H 'Authorization: Bearer <your-admin-key>' \
-H 'Content-Type: application/json' \
-d '{
"logo_url": "https://example.com/your-company-logo.png",
"logo_url_dark": "https://example.com/your-company-logo-dark.png"
}'

logo_url_dark is optional. Omit it and dark mode reuses logo_url.

Set a Custom Favicon​

You can also customize the browser tab favicon:

curl -X PATCH 'http://localhost:4000/update/ui_theme_settings' \
-H 'Authorization: Bearer <your-admin-key>' \
-H 'Content-Type: application/json' \
-d '{
"logo_url": "https://example.com/your-company-logo.png",
"favicon_url": "https://example.com/your-favicon.ico"
}'

Get Current Theme Settings​

curl -X GET 'http://localhost:4000/get/ui_theme_settings'

Send an empty logo_url to restore the default LiteLLM logo:

curl -X PATCH 'http://localhost:4000/update/ui_theme_settings' \
-H 'Authorization: Bearer <your-admin-key>' \
-H 'Content-Type: application/json' \
-d '{
"logo_url": ""
}'

Via proxy_config.yaml​

You can also set the logo URL in your proxy configuration file:

litellm_settings:
ui_theme_config:
logo_url: "https://example.com/your-company-logo.png"
logo_url_dark: "https://example.com/your-company-logo-dark.png" # optional
favicon_url: "https://example.com/your-favicon.ico" # optional

Set UI_LOGO_PATH to a hosted image URL or a file available inside the proxy container. Hosted images are easier to configure and troubleshoot.

UI_LOGO_PATH="https://example.com/your-company-logo.png"
UI_LOGO_PATH_DARK="https://example.com/your-company-logo-dark.png"

For a local image:

UI_LOGO_PATH="ui_images/logo.jpg"

You can also declare the variables in the proxy configuration:

environment_variables:
UI_LOGO_PATH: "https://example.com/your-company-logo.png"
UI_LOGO_PATH_DARK: "https://example.com/your-company-logo-dark.png"

Custom color themes​

The Admin UI no longer supports custom color themes. LiteLLM v1.92.0 and later ignore enterprise_colors.json, and no setting replaces it. To brand the UI, set a custom logo and favicon as described above.

Supported Logo Formats​

FormatSupported
JPEG / JPGYes
PNGYes
SVGYes
ICO (favicon only)Yes
HTTP/HTTPS URLYes
Local file pathYes