Skip to content
Draft

0.7.3 #999

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
47 commits
Select commit Hold shift + click to select a range
f66684b
code-interpreter
Classic298 Jan 11, 2026
1fa5028
Merge pull request #998 from Classic298/dev
Classic298 Jan 11, 2026
c8807fb
Merge pull request #1001 from open-webui/main
Classic298 Jan 12, 2026
6ab1b5c
Update python.md
Classic298 Jan 13, 2026
e00ecf4
Merge pull request #1002 from Classic298/dev
Classic298 Jan 13, 2026
94c28be
Merge pull request #1014 from open-webui/main
Classic298 Jan 16, 2026
e689144
update
Classic298 Jan 16, 2026
5add3a3
Merge pull request #1015 from Classic298/dev
Classic298 Jan 16, 2026
3c3850e
weaviate
Classic298 Jan 17, 2026
4dfecc6
Merge pull request #1018 from Classic298/dev
Classic298 Jan 17, 2026
b152009
engine io
Classic298 Jan 17, 2026
d7f8d45
Merge pull request #1020 from open-webui/main
Classic298 Jan 19, 2026
dff8bbc
Update env-configuration.mdx
Classic298 Jan 19, 2026
b1a87db
Merge pull request #1021 from Classic298/dev
Classic298 Jan 19, 2026
d9aaed6
Merge pull request #1025 from open-webui/main
Classic298 Jan 21, 2026
bd743d6
Update env-configuration.mdx
Classic298 Jan 21, 2026
290be85
Update valves.mdx
Classic298 Jan 21, 2026
9138d4b
Merge pull request #1026 from Classic298/dev
Classic298 Jan 21, 2026
915cacf
fixlinks
Classic298 Jan 21, 2026
25a4c5e
Merge branch 'open-webui:dev' into dev
Classic298 Jan 21, 2026
0c0d59a
Merge pull request #1027 from Classic298/dev
Classic298 Jan 21, 2026
75407a5
updates
Classic298 Jan 22, 2026
ac568bc
Update prompts.md
Classic298 Jan 22, 2026
9930f05
Merge pull request #1029 from Classic298/email
Classic298 Jan 22, 2026
0925cd4
built in
Classic298 Jan 22, 2026
280d549
Merge pull request #1030 from Classic298/dev
Classic298 Jan 22, 2026
8796810
ENABLE_OAUTH_TOKEN_EXCHANGE
Classic298 Jan 25, 2026
a3fbb47
Merge pull request #1033 from Classic298/dev
Classic298 Jan 25, 2026
584a7c5
0.7.3 new env vars, prompts and yandex
Classic298 Jan 26, 2026
873f81b
Merge pull request #1034 from Classic298/dev
Classic298 Jan 26, 2026
b2c23ff
db schema
Classic298 Jan 27, 2026
d4cb35a
SECURITY WARNINGS tools and plugins
Classic298 Jan 27, 2026
df2dbf6
playground
Classic298 Jan 27, 2026
27f9def
sync (#1040)
Classic298 Jan 29, 2026
904f4ae
REDIS
Classic298 Jan 29, 2026
d63d247
Dev (#1041)
Classic298 Jan 29, 2026
02d3eaa
CHAT SHARING FEATURE
Classic298 Jan 29, 2026
b883381
docs: document centralized data management and admin model controls
Classic298 Jan 29, 2026
e86756e
fixes
Classic298 Jan 29, 2026
3091fa7
fixes
Classic298 Jan 29, 2026
0ed3bf2
Dev (#1042)
Classic298 Jan 29, 2026
b22c2cc
data controls
Classic298 Jan 29, 2026
72a9a48
Merge branch 'dev' into dev
Classic298 Jan 29, 2026
7e0dd62
Merge pull request #1044 from Classic298/dev
Classic298 Jan 29, 2026
2881efe
Update env-configuration.mdx
Classic298 Jan 30, 2026
99faa73
Update redis.md
Classic298 Jan 30, 2026
1b8ad69
Update env-configuration.mdx
Classic298 Feb 2, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 9 additions & 1 deletion docs/faq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,14 @@ For more details on enterprise solutions and branding customizations, [click her

**A:** No, your data is never sent anywhere unless you explicitly choose to share it or you connect an external model provider. Everything inside Open WebUI runs and is stored locally on your machine or server, giving you full control over your data at all times. We encourage you not to simply take our word for it: our entire codebase is hosted publicly, so you can inspect exactly how everything works, and if you ever notice anything concerning, please report it to us on our repo immediately.

### Q: How can I see a list of all the chats I've ever shared?

**A:** Open WebUI provides a centralized **Shared Chats** dashboard where you can see every link you've generated. This is available to all users via **Settings > Data Controls > Shared Chats > Manage**. From there, you can search through your shared history, re-copy links, or revoke (unshare) access to any conversation instantly.

### Q: How can I manage or delete files I've uploaded?

**A:** You can access the **File Manager** by going to **Settings > Data Controls > Manage Files > Manage**. This dashboard allows you to search through all your uploaded documents, view their details, and delete them. Deleting a file here also automatically cleans up any associated Knowledge Base entries and vector embeddings.

### Q: Can I use Open WebUI in outer space (e.g., Mars and beyond) or other extreme environments?

**A:** **Yes.** Open WebUI is fully self-hosted and does not rely on persistent internet connectivity, making it suitable for environments where cloud-based systems are impractical or impossible. As long as the underlying hardware can run a supported runtime, Open WebUI will function normally regardless of location.
Expand Down Expand Up @@ -165,7 +173,7 @@ def wait_for_processing(token, file_id):
time.sleep(2) # Wait before checking again
```

For complete workflow examples, see the **[API Endpoints documentation](/getting-started/api-endpoints#checking-file-processing-status)** and the **[RAG Troubleshooting guide](/troubleshooting/rag#9-api-file-upload-the-content-provided-is-empty-error-)**.
For complete workflow examples, see the **[API Endpoints documentation](/getting-started/api-endpoints#checking-file-processing-status)** and the **[RAG Troubleshooting guide](/troubleshooting/rag#9-api-file-upload-the-content-provided-is-empty-error)**.

### Q: I asked the model what it is and it gave the wrong answer. Is Open WebUI routing to the wrong model?

Expand Down
9 changes: 9 additions & 0 deletions docs/features/auth/sso/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ You cannot have Microsoft **and** Google as OIDC providers simultaneously.
| `OAUTH_SESSION_TOKEN_ENCRYPTION_KEY` | `WEBUI_SECRET_KEY` | A secret key for encrypting OAuth tokens stored on the server. Must be shared across all instances in a cluster. |
| `OAUTH_CLIENT_INFO_ENCRYPTION_KEY` | `WEBUI_SECRET_KEY` | A secret key for encrypting OAuth client information stored on the server - used for OAuth 2.1 authentication for MCP servers. |
| `ENABLE_OAUTH_ID_TOKEN_COOKIE` | `true` | For backward compatibility. Controls if the legacy `oauth_id_token` cookie is set. Recommended to set to `false`. |
| `ENABLE_OAUTH_TOKEN_EXCHANGE` | `false` | Enables the token exchange endpoint for external apps to exchange OAuth tokens for Open WebUI JWTs. |

:::warning

Expand Down Expand Up @@ -69,6 +70,14 @@ This system is enabled by default but can be fine-tuned with the environment var

For more information, check out the [environment variable docs page](https://docs.openwebui.com/getting-started/env-configuration/).

### OAuth Token Exchange for External Applications

Open WebUI also supports **OAuth Token Exchange**, allowing external applications to authenticate with Open WebUI by exchanging an OAuth provider's access token for an Open WebUI JWT session token. This is useful for programmatic access from scripts, CLI tools, or services that already have OAuth tokens from your identity provider.

**Example use case:** A CLI tool that has obtained an OAuth access token from your identity provider can exchange it for an Open WebUI token to make API calls to Open WebUI.

To enable this feature, set `ENABLE_OAUTH_TOKEN_EXCHANGE=true`. See the [`ENABLE_OAUTH_TOKEN_EXCHANGE`](/getting-started/env-configuration#enable_oauth_token_exchange) environment variable documentation for details on usage, request/response examples, and security considerations.

### Google

To configure a Google OAuth client, please refer to [Google's documentation](https://support.google.com/cloud/answer/6158849) on how to create a Google OAuth client for a **web application**.
Expand Down
6 changes: 6 additions & 0 deletions docs/features/chat-features/chatshare.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,3 +110,9 @@ Once deleted, the shared link will no longer be valid, and users will not be abl
4. Click on the chat you wish to change permission access for.
5. Scroll to the bottom of the chat and update its permission level.
6. Click the **Update Chat** button.

### Managing Shared Chats

Open WebUI provides a centralized dashboard to manage every chat conversation you have shared. From there you can search through your shared history, re-copy links, or revoke access instantly.

For details on the management dashboard, see [Shared Chats Management](/features/data-controls/shared-chats).
4 changes: 3 additions & 1 deletion docs/features/chat-features/code-execution/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,9 @@ Open WebUI offers powerful code execution capabilities directly within your chat

## Key Features

- **Python Code Execution**: Run Python scripts directly in your browser using Pyodide, with support for popular libraries like pandas and matplotlib with no setup required.
- **Code Interpreter Capability**: Enable models to autonomously write and execute Python code as part of their responses. Works with both Default Mode (XML-based) and Native Mode (tool calling via `execute_code`).

- **Python Code Execution**: Run Python scripts directly in your browser using Pyodide, or on a server using Jupyter. Supports popular libraries like pandas and matplotlib with no setup required.

- **MermaidJS Rendering**: Create and visualize flowcharts, diagrams, and other visual representations with MermaidJS syntax that automatically renders in your chat.

Expand Down
44 changes: 41 additions & 3 deletions docs/features/chat-features/code-execution/python.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,20 @@ These settings can be configured at **Admin Panel → Settings → Code Executio

For Jupyter configuration, see the [Jupyter Notebook Integration](/tutorials/integrations/jupyter) tutorial.

### Native Function Calling (Native Mode)

When using **Native function calling mode** with a capable model (e.g., GPT-5, Claude 4.5, MiniMax M2.1), the code interpreter is available as a builtin tool called `execute_code`. This provides a more integrated experience:

- **No XML tags required**: The model calls `execute_code(code)` directly
- **Same image handling**: Base64 image URLs in output are replaced with file URLs; model embeds via markdown

**Requirements:**
1. `ENABLE_CODE_INTERPRETER` must be enabled globally
2. Model must have `code_interpreter` capability enabled
3. Model must use **Native** function calling mode (set in model's advanced params)

For more details on builtin tools and native mode, see the [Tool Development Guide](/features/plugin/tools#built-in-system-tools-nativeagentic-mode).

## Displaying Images Inline (matplotlib, etc.)

When using matplotlib or other visualization libraries, images can be displayed directly in the chat. For this to work correctly, the code must output the image as a **base64 data URL**.
Expand Down Expand Up @@ -92,9 +106,7 @@ If you see raw base64 text appearing in chat responses, the model is incorrectly

### Example Prompt

> Create a bar chart showing quarterly sales: Q1: 150, Q2: 230, Q3: 180, Q4: 310.
> Use matplotlib, save the figure to a BytesIO buffer, encode it as base64, and print the data URL.
> After the code runs, use the resulting file URL from the output to display the image in your response.
> Create a bar chart showing quarterly sales: Q1: 150, Q2: 230, Q3: 180, Q4: 310.

**Expected model behavior:**
1. Model writes Python code using the base64 pattern above
Expand Down Expand Up @@ -175,6 +187,32 @@ plt.close()

The image will be automatically uploaded and displayed inline in your chat.

## Browser Compatibility

### Microsoft Edge: Pyodide Crashes

If Pyodide-based code execution causes Microsoft Edge to crash with a `STATUS_ACCESS_VIOLATION` error, this is caused by Edge's enhanced security mode.

**Symptom:** The browser tab or entire browser crashes when attempting to run Python code, with no useful error message.

**Cause:** Edge's "Enhance your security on the web" setting (found at `edge://settings/privacy/security`) enables stricter security mitigations that are incompatible with WebAssembly-based runtimes like Pyodide.

**Solutions:**

1. **Disable enhanced security in Edge:**
- Go to `edge://settings/privacy/security`
- Turn off **"Enhance your security on the web"**

2. **Use a different browser:**
- Chrome and Firefox do not have this issue

3. **Use Jupyter backend:**
- Switch `CODE_INTERPRETER_ENGINE` to `jupyter` to avoid browser-based execution entirely

:::note
This is a known compatibility issue between Edge's enhanced security mode and WebAssembly. The same crash occurs on the official [Pyodide console](https://pyodide.org/en/stable/console.html) when this setting is enabled.
:::

## Tips for Better Results

- **Mention the environment**: Tell the LLM it's running in a "Pyodide environment" or "code interpreter" for better code generation
Expand Down
42 changes: 42 additions & 0 deletions docs/features/data-controls/archived-chats.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
---
sidebar_position: 3
title: "📦 Archived Chats"
---

Open WebUI allows you to archive conversations to declutter your sidebar while preserving them for future reference. The **Archived Chats** dashboard lets you manage all your archived conversations in one place.

## Accessing Archived Chats

1. Click on your **profile name** or avatar in the bottom-left corner of the sidebar.
2. Select **Settings** from the menu.
3. Navigate to the **Data Controls** tab.
4. Locate the **Archived Chats** row and click the **Manage** button.

## Dashboard Features

The **Archived Chats** modal provides tools to manage your archived conversations:

- **Search**: Quickly find archived chats by title using the search bar.
- **Restore**: Bring an archived chat back to your main sidebar.
- **Delete**: Permanently remove an archived chat from your account.

## Bulk Operations

From the Data Controls tab, you can also perform bulk operations:

- **Archive All Chats**: Move all your current conversations to the archive at once. This is useful for periodic cleanup.
- **Delete All Chats**: Permanently remove all conversations (both active and archived).
- :::warning
This action cannot be undone. All chat history will be permanently deleted.
:::

## FAQ

**Q: Can I search within archived chats?**
**A:** The archive dashboard searches by chat title. To search within message content, you would need to restore the chat first.

**Q: Is there a limit to how many chats I can archive?**
**A:** There is no hard limit. The scalability depends on your database configuration.

**Q: Do archived chats still use storage?**
**A:** Yes. Archived chats remain in your database. To free up space, you must permanently delete them.
65 changes: 65 additions & 0 deletions docs/features/data-controls/files.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
sidebar_position: 5
title: "📁 File Management"
---

Open WebUI provides a comprehensive file management system that allows you to upload, organize, and utilize your documents across various features like Knowledge Bases and RAG.

## Centralized File Manager

The **Centralized File Manager** provides a unified interface to view, search, and manage every file you have uploaded to your Open WebUI instance, whether it was uploaded directly to a chat or into a Knowledge Base.

### Accessing the File Manager

1. Click on your **profile name** or avatar in the bottom-left corner.
2. Select **Settings** from the menu.
3. Navigate to the **Data Controls** tab.
4. Locate the **Manage Files** row and click the **Manage** button.

### Key Features

The File Manager modal offers several powerful tools for maintaining your data:

- **Universal Search**: Quickly find any file by its filename using the integrated search bar.
- **Advanced Sorting**: Organize your file list by:
- **Filename**: Sort alphabetically to find specific documents.
- **Created At**: See your most recent uploads or find older files.
- **File Details**: View important information at a glance, including:
- **File Size**: See how much space each document occupies (e.g., KB, MB).
- **Upload Date**: Track when each file was added to your instance.
- **Built-in Viewer**: Click on any file to open the **File Item Viewer**, which displays the file's metadata and specific details (such as size and type).
- **Safe Deletion**: Easily remove files you no longer need.
- :::info **Knowledge Base Cleanup**
When you delete a file through the File Manager, Open WebUI automatically performs a deep cleanup. It removes the file from all associated Knowledge Bases and deletes its corresponding vector embeddings, ensuring your database stays clean and efficient.
:::

## Using Files in Open WebUI

Files are at the heart of the platform's advanced capabilities:

### 1. Retrieval Augmented Generation (RAG)
By uploading documents (PDFs, Word docs, text files, etc.), you can ground your AI's responses in your own data.
- **Chat Uploads**: Simply drag and drop files into a chat or use the upload icon.
- **Knowledge Bases**: Add files to structured collections for more permanent and organized retrieval.

### 2. File Metadata
Every file carries metadata that helps both you and the AI understand its context. This includes content type, original filename, and size.

## Best Practices

- **Naming Conventions**: Use clear, descriptive filenames. This improves the accuracy of the File Manager's search and helps you identify specific documents.
- **Regular Audits**: Periodically use the **Manage Files** dashboard to delete old or redundant documents. This saves disk/database space and improves the performance of your system by ensuring only relevant data is retained.

## FAQ

**Q: If I delete a file, is it gone from my chats?**
**A:** Yes. Deleting a file via the File Manager removes it from the system entirely. Any chat that referenced that file using RAG will no longer be able to pull information from it.

**Q: Can I download my files back from the File Manager?**
**A:** Currently, the File Manager focuses on viewing metadata and management (deletion). To download a file, you should typically access it from the original chat or Knowledge Base where it was used.

**Q: Are there limits on the number of files I can manage?**
**A:** There is no hard-coded limit in Open WebUI. The scalability depends on your storage (disk/S3) and your Vector Database (e.g., ChromaDB, PGVector).

**Q: Does managing files require Admin privileges?**
**A:** Regular users can manage their *own* uploaded files. Administrators have additional tools to manage global files and configuration via the Admin Panel.
50 changes: 50 additions & 0 deletions docs/features/data-controls/import-export.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
sidebar_position: 4
title: "💾 Import & Export"
---

Open WebUI provides tools to backup your chat history and restore it later, or migrate conversations from other platforms.

## Accessing Import & Export

1. Click on your **profile name** or avatar in the bottom-left corner of the sidebar.
2. Select **Settings** from the menu.
3. Navigate to the **Data Controls** tab.
4. Use the **Import Chats** or **Export Chats** buttons.

## Exporting Chats

Click the **Export Chats** button to download all your conversations as a JSON file. This backup includes:

- All chat messages and their metadata
- Model information used in each conversation
- Timestamps and conversation structure

:::tip Regular Backups
It's a good practice to periodically export your chats, especially before major updates or migrations.
:::

## Importing Chats

Click the **Import Chats** button and select a JSON file to restore conversations. Open WebUI supports importing from:

- **Open WebUI exports**: Native JSON format from previous exports
- **ChatGPT exports**: Conversations exported from OpenAI's ChatGPT
- **Other compatible formats**: JSON files following the expected structure

### Import Behavior

- Imported chats are added to your existing conversations (they don't replace them)
- Duplicate detection may vary based on chat IDs
- If using ChatGPT exports, the format is automatically converted

## FAQ

**Q: Will importing chats overwrite my existing conversations?**
**A:** No. Imported chats are added alongside your existing conversations.

**Q: Can I import chats from Claude, Gemini, or other platforms?**
**A:** Currently, native import support is available for Open WebUI and ChatGPT formats. Other platforms may require manual conversion to the expected JSON structure.

**Q: Is there a size limit for imports?**
**A:** There's no hard-coded limit, but very large files may take longer to process. The practical limit depends on your server configuration and available memory.
13 changes: 13 additions & 0 deletions docs/features/data-controls/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
sidebar_position: 15
title: "Data Controls"
---

The **Data Controls** section in Open WebUI provides tools for managing your personal data, including files, shared content, and chat history. Access it via **Settings > Data Controls**.

## Resources

- [📁 File Management](./files.md) - Centralized management for all your uploaded documents
- [🔗 Shared Chats](./shared-chats.md) - Manage and revoke access to your shared chat links
- [📦 Archived Chats](./archived-chats.md) - Restore or permanently delete archived conversations
- [💾 Import & Export](./import-export.md) - Backup and restore your chat history
44 changes: 44 additions & 0 deletions docs/features/data-controls/shared-chats.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
sidebar_position: 2
title: "🔗 Shared Chats"
---

Open WebUI provides a centralized dashboard to manage every chat conversation you have shared. This feature allows users to audit their shared content and quickly revoke access if needed.

:::info
This page documents the **management dashboard** for shared chats. For information on how to share chats, see [Chat Sharing](/features/chat-features/chatshare).
:::

## Accessing the Management Dashboard

1. Click on your **profile name** or avatar in the bottom-left corner of the sidebar.
2. Select **Settings** from the menu.
3. Navigate to the **Data Controls** tab.
4. Locate the **Shared Chats** row and click the **Manage** button.

## Dashboard Features

The **Shared Chats** modal provides a unified interface for your public content:

- **Centralized List**: View all conversations that have an active share link.
- **Search & Filter**: Quickly find specific shared chats by title. The search bar includes a **500ms debounce** to ensure smooth performance while typing.
- **Advanced Sorting**: Organize your shared history by:
- **Updated At** (Default)
- **Title**
- **Copy Link**: Use the **Clipboard icon** next to any entry to instantly copy the share URL back to your clipboard.
- **Revoke Access (Unshare)**: Use the **Unshare icon** (represented by a slashed link) to deactivate a share link.
- :::warning
Revoking access immediately invalidates the link. Anyone attempting to visit the URL will receive a "Not Found" error. This action is permanent, though you can generate a *new* unique link by sharing the chat again from the main interface.
:::
- **Pagination**: Efficiently browse through your history using the "Load More" functionality at the bottom of the list.

## FAQ

**Q: Does unsharing a chat delete the original conversation?**
**A:** No. Unsharing only deletes the public link. Your original chat history remains completely intact.

**Q: Can I manage chats I've shared on the community platform here?**
**A:** No. This dashboard manages links generated on your local instance. For community-shared content, see [Deleting Shared Chats](/features/chat-features/chatshare#deleting-shared-chats).

**Q: If I delete my original chat, what happens to the shared link?**
**A:** Deleting a chat also immediately invalidates and deletes any associated share links.
Loading