Customize UI Logo

Personalize your LiteLLM dashboard by replacing the default logo with your own company branding. You can set a custom logo via the UI or the API.

Via the UI

1. Navigate to Settings

Click the Settings icon in the sidebar.

2. Open UI Theme Settings

Click UI Theme from the settings menu.

3. Click the Logo URL Field

Click the Logo URL text field to start editing.

4. Find Your Logo Image

Open a new browser tab and find the logo image you want to use (e.g., search Google Images for your company logo).

5. Right-Click on the Logo Image

Right-click the image you want to use as your logo.

6. Copy the Image Address

Select Copy Image Address from the context menu to copy the URL.

7. Switch Back to LiteLLM

Navigate back to the LiteLLM UI tab (e.g., press Cmd + Left or click the tab).

8. Paste the Logo URL

Paste the copied image URL into the Logo URL field with Cmd + V.

9. Save Changes

Click Save Changes to apply your new logo.

Your custom logo will now appear in the LiteLLM dashboard sidebar and login page.

Dark Mode Logo

A logo drawn for a light background rarely reads well on a dark one, so you can set a second logo that LiteLLM uses whenever the dashboard is in dark mode. Fill in Custom Logo URL (dark mode) on the same UI Theme page, or set UI_LOGO_PATH_DARK

Leaving it empty is a valid choice. Dark mode then reuses whatever you set for the light logo, so your branding still shows rather than reverting to LiteLLM's. The same thing happens if the dark logo is set but cannot be loaded, which means a broken or deleted image never costs you your branding

Setting only the dark logo leaves light mode on the default LiteLLM logo, so set both if you want your own artwork in each theme

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

Or set them as environment variables:

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

Supported Logo Formats

Format	Supported
JPEG / JPG	Yes
PNG	Yes
SVG	Yes
ICO (favicon only)	Yes
HTTP/HTTPS URL	Yes
Local file path	Yes