---
title: "UI Troubleshooting"
url: "/docs/troubleshoot/ui_issues"
canonical_url: "https://docs.litellm.ai/docs/troubleshoot/ui_issues"
type: "docs"
last_updated: "2026-10-14"
summary: "If you're experiencing issues with the LiteLLM Admin UI, please include the following information when reporting."
related:
  - "/docs/provider_registration/add_model_pricing"
  - "/docs/troubleshoot/cost_discrepancy"
---
# UI Troubleshooting

> Index of all LiteLLM docs: https://docs.litellm.ai/llms.txt


If you're experiencing issues with the LiteLLM Admin UI, please include the following information when reporting.

## 1. Steps to Reproduce

A clear, step-by-step description of how to trigger the issue (e.g., "Navigate to Settings → Team, click 'Create Team', fill in fields, click submit → error appears").

## 2. LiteLLM Version

The current version of LiteLLM you're running. Check via `litellm --version` or the UI's settings page.

## 3. Architecture & Deployment Setup

Distributed environments are a known source of UI issues. Please describe:

- **Number of LiteLLM instances/replicas** and how they are deployed (e.g., Kubernetes, Docker Compose, ECS)
- **Load balancer** type and configuration (e.g., ALB, Nginx, Cloudflare Tunnel), including whether sticky sessions are enabled
- **How the UI is accessed** — directly via LiteLLM, through a reverse proxy, or behind an ingress controller
- **Any CDN or caching layers** between the user and the LiteLLM server

## 4. Network Tab Requests

Open your browser's Developer Tools (F12 → Network tab), reproduce the issue, and share:

- The **failing request(s)**: URL, method, status code, and response body
- **Screenshots or HAR export** of the relevant network activity
- Any **CORS or mixed-content errors** shown in the Console tab

## 5. Environment Variables

Non-sensitive environment variables related to the UI and proxy setup, such as:

- `LITELLM_MASTER_KEY`
- `PROXY_BASE_URL` / `LITELLM_PROXY_BASE_URL`
- `UI_BASE_PATH`
- Any SSO-related variables (e.g., `GOOGLE_CLIENT_ID`, `MICROSOFT_TENANT`)

Do **not** include passwords, secrets, or API keys.

## 6. Browser & Access Details

- **Browser** and version (e.g., Chrome 120, Firefox 121)
- **Access URL** used to reach the UI (redact sensitive parts)
- Whether the issue occurs for **all users or specific roles** (Admin, Internal User, etc.)

## 7. Screenshots or Screen Recordings

A screenshot or short screen recording of the issue is extremely helpful. Include any visible error messages, toasts, or unexpected behavior.

## Related pages

- [Add Model Pricing & Context Window](https://docs.litellm.ai/docs/provider_registration/add_model_pricing.md)
- [Debugging a cost discrepancy](https://docs.litellm.ai/docs/troubleshoot/cost_discrepancy.md)