From 95da14cb968d399227af01d3e01075a07548761c Mon Sep 17 00:00:00 2001
From: Boopesh Shanmugam <51117963+boopesh07@users.noreply.github.com>
Date: Sat, 13 Sep 2025 16:58:10 -0700
Subject: [PATCH] Docs update on user header mapping (#14527)
---
docs/my-website/docs/tutorials/openweb_ui.md | 16 +++++++++++++---
1 file changed, 13 insertions(+), 3 deletions(-)
diff --git a/docs/my-website/docs/tutorials/openweb_ui.md b/docs/my-website/docs/tutorials/openweb_ui.md
index ecf1e289da3..38f1ec38260 100644
--- a/docs/my-website/docs/tutorials/openweb_ui.md
+++ b/docs/my-website/docs/tutorials/openweb_ui.md
@@ -89,16 +89,20 @@ To track spend and usage for each Open WebUI user, configure both Open WebUI and
2. **Configure LiteLLM to Parse User Headers**
- Add the following to your LiteLLM `config.yaml` to specify a header to use for user tracking:
+ Add the following to your LiteLLM `config.yaml` to specify the request header mapping for user tracking:
```yaml
general_settings:
- user_header_name: X-OpenWebUI-User-Id
+ user_header_mappings:
+ - header_name: X-OpenWebUI-User-Id
+ litellm_user_role: internal_user
+ - header_name: X-OpenWebUI-User-Email
+ litellm_user_role: customer
```
ⓘ Available tracking options
- You can use any of the following headers for `user_header_name`:
+ You can use any of the following headers in `header_name` in `user_header_mappings` :
- `X-OpenWebUI-User-Id`
- `X-OpenWebUI-User-Email`
- `X-OpenWebUI-User-Name`
@@ -109,6 +113,12 @@ To track spend and usage for each Open WebUI user, configure both Open WebUI and
- Users can modify their own usernames
- Administrators can modify both usernames and emails of any account
+This video walks through on how we can map the openweb ui headers to LiteLLM user roles
+
+
+
+
+
## Render `thinking` content on Open WebUI