Customize UI branding
Customize the Admin UI logo and favicon.
Via the UI
- Open Settings → UI Theme.
- Paste a hosted image URL into Logo URL. Optionally set Custom Logo URL (dark mode).
- Click Save Changes. The logo appears in the dashboard sidebar and login page.


Dark Mode Logo
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
Set a Custom 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": "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'
Reset to Default Logo
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
Environment variables
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
| Format | Supported |
|---|---|
| JPEG / JPG | Yes |
| PNG | Yes |
| SVG | Yes |
| ICO (favicon only) | Yes |
| HTTP/HTTPS URL | Yes |
| Local file path | Yes |