open-webui · Classic298 · Jun 6, 2026 · Jun 6, 2026 · Jun 6, 2026 · Jun 6, 2026
diff --git a/.gitignore b/.gitignore
@@ -8,6 +8,9 @@
 .docusaurus
 .cache-loader
 
+# Local banner render scratch (not for commit)
+.scratch_banner
+
 # Misc
 .DS_Store
 .env.local

diff --git a/docs/features/administration/_category_.json b/docs/features/administration/_category_.json
@@ -1,6 +1,6 @@
 {
 	"label": "🔧 Administration",
-	"position": 10,
+	"position": 46,
 	"collapsible": true,
 	"collapsed": true
 }
diff --git a/docs/features/administration/index.mdx b/docs/features/administration/index.mdx
@@ -3,8 +3,20 @@ sidebar_position: 0
 title: "Administration"
 ---
 
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
 # 🔧 Administration
 
+<ThemedImage
+  alt="Administration: the Admin Panel dashboard with usage stats and a messages-over-time chart"
+  sources={{
+    light: useBaseUrl('/images/banners/administration-light.svg'),
+    dark: useBaseUrl('/images/banners/administration-dark.svg'),
+  }}
+  style={{ width: '100%', margin: '0.25rem 0 1.75rem' }}
+/>
+
 **Monitor usage, evaluate model quality, and communicate with your users, all from the Admin Panel.**
 
 Open WebUI gives administrators a full operational toolkit. Track which models your team uses and how much they cost. Run blind evaluations to find the best model for your workload. Push announcements to every user with customizable banners. Wire up webhooks to get notified when users sign up or when long-running tasks finish.

diff --git a/docs/features/authentication-access/_category_.json b/docs/features/authentication-access/_category_.json
@@ -1,6 +1,6 @@
 {
 	"label": "🔐 Authentication & Access",
-	"position": 9,
+	"position": 45,
 	"collapsible": true,
 	"collapsed": true
 }
diff --git a/docs/features/authentication-access/index.mdx b/docs/features/authentication-access/index.mdx
@@ -3,8 +3,20 @@ sidebar_position: 0
 title: "Authentication & Access"
 ---
 
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
 # 🔐 Authentication & Access
 
+<ThemedImage
+  alt="Authentication & Access: a sign-in card with SSO providers beside a roles and access-control panel"
+  sources={{
+    light: useBaseUrl('/images/banners/authentication-access-light.svg'),
+    dark: useBaseUrl('/images/banners/authentication-access-dark.svg'),
+  }}
+  style={{ width: '100%', margin: '0.25rem 0 1.75rem' }}
+/>
+
 **Control who gets in, what they can do, and how your instance integrates with your identity stack.**
 
 Open WebUI is multi-user from day one. Whether you're running a personal instance or managing thousands of seats across an organization, you have full control over authentication, authorization, and programmatic access. Connect your identity provider, define granular permissions, and automate user lifecycle management, all without touching a line of code.

diff --git a/docs/features/calendar/index.md b/docs/features/calendar/index.md
@@ -3,8 +3,20 @@ sidebar_position: 2
 title: "Calendar"
 ---
 
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
 # 📅 Calendar
 
+<ThemedImage
+  alt="Calendar: a month grid with color-coded events and a recurring weekday standup, with AI creating events from a natural-language request"
+  sources={{
+    light: useBaseUrl('/images/banners/calendar-light.svg'),
+    dark: useBaseUrl('/images/banners/calendar-dark.svg'),
+  }}
+  style={{ width: '100%', margin: '0.25rem 0 1.75rem' }}
+/>
+
 **Schedule, track, and manage events, with AI that can plan for you.**
 
 Calendar is a built-in scheduling feature that gives every user a personal calendar. Create events, set recurring schedules, share calendars with teammates, and let AI models autonomously create and manage events through natural conversation.

diff --git a/docs/features/channels/index.md b/docs/features/channels/index.md
@@ -3,8 +3,20 @@ sidebar_position: 1000
 title: "Channels"
 ---
 
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
 # 💬 Channels
 
+<ThemedImage
+  alt="Channels: a shared #product-launch channel where people and AI models talk in one timeline, summoned with @model mentions"
+  sources={{
+    light: useBaseUrl('/images/banners/channels-light.svg'),
+    dark: useBaseUrl('/images/banners/channels-dark.svg'),
+  }}
+  style={{ width: '100%', margin: '0.25rem 0 1.75rem' }}
+/>
+
 **Where your team and AI think together, in real time.**
 
 Channels are persistent, shared spaces where humans and AI models participate in the same conversation. Unlike standard chats, which are personal and isolated, Channels let multiple users and multiple models interact in a single timeline. Every exchange, whether human or AI, becomes shared context that the whole team can build on.

diff --git a/docs/features/chat-conversations/audio/_category_.json b/docs/features/chat-conversations/audio/_category_.json
@@ -1,8 +1,4 @@
 {
 	"label": "Speech-to-Text & Text-to-Speech",
-	"position": 500,
-	"link": {
-		"type": "generated-index",
-		"slug": "/features/chat-conversations/audio"
-	}
+	"position": 500
 }
diff --git a/docs/features/chat-conversations/audio/index.mdx b/docs/features/chat-conversations/audio/index.mdx
@@ -0,0 +1,24 @@
+---
+title: "Speech-to-Text & Text-to-Speech"
+sidebar_position: 0
+slug: /features/chat-conversations/audio
+---
+
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+import DocCardList from '@theme/DocCardList';
+
+# 🎙️ Audio
+
+<ThemedImage
+  alt="Chat & Conversations map with the Audio cell highlighted"
+  sources={{
+    light: useBaseUrl('/images/banners/chat-conversations-audio-light.svg'),
+    dark: useBaseUrl('/images/banners/chat-conversations-audio-dark.svg'),
+  }}
+  style={{ width: '100%', margin: '0.25rem 0 1.75rem' }}
+/>
+
+Talk to Open WebUI and have it talk back. Dictate with speech-to-text and hear responses with text-to-speech, across a range of engines and voices.
+
+<DocCardList />
diff --git a/docs/features/chat-conversations/chat-features/code-execution/artifacts.md b/docs/features/chat-conversations/chat-features/code-execution/artifacts.md
@@ -32,6 +32,22 @@ When Open WebUI creates an Artifact, you'll see the content displayed in a dedic
 - **Updates**: Open WebUI may update an existing Artifact based on your messages. The Artifact window will display the latest content.
 - **Actions**: Access additional actions for the Artifact, such as copying the content or opening the artifact in full screen, located in the lower right corner of the Artifact.
 
+## Securing artifact previews with a CSP
+
+Artifact previews render inside a sandboxed `srcdoc` iframe. For tighter control over what that generated HTML can do (outbound network calls, scripts, styles), inject a dedicated Content Security Policy into the preview with the [`IFRAME_CSP`](/reference/env-configuration#iframe_csp) environment variable, separate from the main app's `CONTENT_SECURITY_POLICY`.
+
+It is empty by default (the iframe `sandbox` already provides baseline isolation) and applies to **every** `srcdoc` iframe in the UI: Artifacts, code/HTML previews, file previews and citation modals. When set, Open WebUI prepends a `<meta http-equiv="Content-Security-Policy">` tag to the iframe document, and per the CSP spec the first policy wins, so it overrides any CSP the generated HTML already declares. A reasonable starting point:
+
+```bash
+IFRAME_CSP=default-src 'self' 'unsafe-inline' 'unsafe-eval' data: blob:; connect-src 'none'
+```
+
+That keeps inline scripts and styles working (most artifacts need them) while blocking `fetch` / `XMLHttpRequest` / `WebSocket`, so an artifact cannot quietly call out to the network.
+
+:::tip Start permissive, then tighten
+An overly strict policy can make a preview appear blank, since many artifacts rely on inline `<script>` and `<style>`. Start permissive and narrow from there. `IFRAME_CSP` is a startup environment variable (not an Admin Panel setting), so changing it requires a restart. For the security-focused walkthrough, see [Hardening → Iframe content-security-policy](/getting-started/advanced-topics/hardening#iframe-content-security-policy).
+:::
+
 ## Editing Artifacts
 
 1. **Targeted Updates**: Describe what you want changed and where. For example:
@@ -112,3 +128,11 @@ If you encounter an issue where the code preview in the chat interface does not
 1. Go to **Settings > Interface**.
 2. Toggle on **Allow Iframe Sandbox Same-Origin Access**.
 3. Save your settings.
+
+### Artifact Preview Is Blank After Setting a CSP
+
+If previews stop rendering after you set [`IFRAME_CSP`](/reference/env-configuration#iframe_csp), the policy is blocking something the generated HTML needs.
+
+1. Open your browser developer tools and look for **CSP violation** messages in the console.
+2. Relax the policy for just the blocked resource type or origin (commonly inline `script` / `style`, `eval`, or a specific image, font or `connect` origin).
+3. To rule the CSP out entirely, temporarily unset `IFRAME_CSP` and restart; the preview falls back to sandbox-only isolation.
diff --git a/docs/features/chat-conversations/chat-features/code-execution/index.md b/docs/features/chat-conversations/chat-features/code-execution/index.md
@@ -7,7 +7,7 @@ Open WebUI offers powerful code execution capabilities directly within your chat
 
 ## Key Features
 
-- **Code Interpreter Capability**: Enable models to autonomously write and execute Python code as part of their responses. Runs via the `execute_code` tool in Native (Agentic) Mode — the only supported tool-calling mode. An older XML-based integration exists for legacy Default Mode but is unsupported; new deployments should use Native Mode.
+- **Code Interpreter Capability**: Enable models to autonomously write and execute Python code as part of their responses. In Native (Agentic) Mode, the only supported tool-calling mode, this runs via the `execute_code` tool. The older XML-based mechanism is itself the legacy approach and is unsupported, so new deployments should stay on Native Mode.
 
 - **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.
 

diff --git a/docs/features/chat-conversations/chat-features/code-execution/python.md b/docs/features/chat-conversations/chat-features/code-execution/python.md
@@ -64,7 +64,7 @@ When using **Native function calling mode** with a capable model (e.g., GPT-5, C
 **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)
+3. Model must be in **Native** function calling mode (the default as of v0.9.7; only an issue if it was switched to **Legacy** in the model's advanced params)
 
 For more details on builtin tools and native mode, see the [Tool Development Guide](/features/extensibility/plugin/tools#built-in-system-tools-nativeagentic-mode).
 

diff --git a/docs/features/chat-conversations/chat-features/index.mdx b/docs/features/chat-conversations/chat-features/index.mdx
@@ -3,8 +3,20 @@ sidebar_position: 1
 title: "Chat Features"
 ---
 
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
 # Chat Features Overview
 
+<ThemedImage
+  alt="Chat & Conversations map with the Chat Features cell highlighted"
+  sources={{
+    light: useBaseUrl('/images/banners/chat-conversations-chat-light.svg'),
+    dark: useBaseUrl('/images/banners/chat-conversations-chat-dark.svg'),
+  }}
+  style={{ width: '100%', margin: '0.25rem 0 1.75rem' }}
+/>
+
 Open WebUI provides a comprehensive set of chat features designed to enhance your interactions with AI models. This page provides an overview of the key chat capabilities, with links to dedicated pages for more detailed information.
 
 ## Core Chat Features

diff --git a/docs/features/chat-conversations/chat-features/url-params.md b/docs/features/chat-conversations/chat-features/url-params.md
@@ -47,7 +47,7 @@ The following table lists the available URL parameters, their function, and exam
 
 ### 4. **Web Search**
 
-- **Description**: Enabling `web-search` allows the chat session to access [web search](/category/web-search/) functionality.
+- **Description**: Enabling `web-search` allows the chat session to access [web search](/features/chat-conversations/web-search) functionality.
 - **How to Set**: Set this parameter to `true` to enable web search.
 - **Example**: `/?web-search=true`
 - **Behavior**: If enabled, the chat can retrieve web search results as part of its responses.

diff --git a/docs/features/chat-conversations/data-controls/index.mdx b/docs/features/chat-conversations/data-controls/index.mdx
@@ -3,6 +3,18 @@ sidebar_position: 15
 title: "Data Controls"
 ---
 
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+<ThemedImage
+  alt="Chat & Conversations map with the Data Controls cell highlighted"
+  sources={{
+    light: useBaseUrl('/images/banners/chat-conversations-data-light.svg'),
+    dark: useBaseUrl('/images/banners/chat-conversations-data-dark.svg'),
+  }}
+  style={{ width: '100%', margin: '0.25rem 0 1.75rem' }}
+/>
+
 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

diff --git a/docs/features/chat-conversations/direct-connections.mdx b/docs/features/chat-conversations/direct-connections.mdx
@@ -3,6 +3,18 @@ sidebar_position: 1510
 title: "Direct Connections"
 ---
 
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+<ThemedImage
+  alt="Chat & Conversations map with the Direct Connections cell highlighted"
+  sources={{
+    light: useBaseUrl('/images/banners/chat-conversations-connections-light.svg'),
+    dark: useBaseUrl('/images/banners/chat-conversations-connections-dark.svg'),
+  }}
+  style={{ width: '100%', margin: '0.25rem 0 1.75rem' }}
+/>
+
 :::warning Experimental Feature
 This feature is currently **experimental** and may change or be removed in future releases.
 :::

diff --git a/docs/features/chat-conversations/image-generation-and-editing/_category_.json b/docs/features/chat-conversations/image-generation-and-editing/_category_.json
@@ -1,8 +1,4 @@
 {
 	"label": "Create & Edit Images",
-	"position": 400,
-	"link": {
-		"type": "generated-index",
-		"slug": "/features/chat-conversations/image-generation-and-editing"
-	}
+	"position": 400
 }
diff --git a/docs/features/chat-conversations/image-generation-and-editing/index.mdx b/docs/features/chat-conversations/image-generation-and-editing/index.mdx
@@ -0,0 +1,24 @@
+---
+title: "Create & Edit Images"
+sidebar_position: 0
+slug: /features/chat-conversations/image-generation-and-editing
+---
+
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+import DocCardList from '@theme/DocCardList';
+
+# 🎨 Image Generation
+
+<ThemedImage
+  alt="Chat & Conversations map with the Image Generation cell highlighted"
+  sources={{
+    light: useBaseUrl('/images/banners/chat-conversations-images-light.svg'),
+    dark: useBaseUrl('/images/banners/chat-conversations-images-dark.svg'),
+  }}
+  style={{ width: '100%', margin: '0.25rem 0 1.75rem' }}
+/>
+
+Generate and edit images from a prompt without leaving the chat, using a local or hosted image model.
+
+<DocCardList />
diff --git a/docs/features/chat-conversations/index.mdx b/docs/features/chat-conversations/index.mdx
@@ -0,0 +1,36 @@
+---
+title: "Chat & Conversations"
+sidebar_position: 0
+slug: /features/chat-conversations
+---
+
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+# 💬 Chat & Conversations
+
+<ThemedImage
+  alt="Chat & Conversations overview: the Open WebUI core ringed by its capabilities (Chat, Documents, Web Search, Audio, Images, Memory, Data Controls and Connections)"
+  sources={{
+    light: useBaseUrl('/images/banners/chat-conversations-light.svg'),
+    dark: useBaseUrl('/images/banners/chat-conversations-dark.svg'),
+  }}
+  style={{ width: '100%', margin: '0.25rem 0 1.75rem' }}
+/>
+
+**The conversation is the heart of Open WebUI, and it does far more than trade messages.**
+
+A single chat can read your documents, search the live web, speak and listen, generate images, remember what matters and call your own models. Everything below plugs into the same conversation. Start with a plain chat and switch capabilities on as you need them.
+
+| Capability | What it does |
+| :--- | :--- |
+| [**💬 Chat Features**](/features/chat-conversations/chat-features) | The everyday chat: editing and regenerating messages, formatting, follow-up suggestions, autocomplete, task management and temporal awareness. |
+| [**📄 Documents (RAG)**](/features/chat-conversations/rag) | Attach files and let the model retrieve the relevant passages instead of guessing, with control over extraction and chunking. |
+| [**🌐 Web Search**](/features/chat-conversations/web-search) | Let the model search the live web and fetch URLs, cite its sources and save results back to a Knowledge Base. |
+| [**🎙️ Audio**](/features/chat-conversations/audio) | Speak to the AI and have it speak back, with pluggable speech-to-text and text-to-speech engines and voice cloning. |
+| [**🎨 Image Generation**](/features/chat-conversations/image-generation-and-editing) | Create and edit images from a prompt inline in chat via local or hosted image models. |
+| [**🧠 Memory**](/features/chat-conversations/memory) | Let the AI remember facts about you across conversations for answers tailored to your context. |
+| [**🔒 Data Controls**](/features/chat-conversations/data-controls) | Decide what is kept, shared and sent: chat history, temporary chats and per-request privacy. |
+| [**🔗 Direct Connections**](/features/chat-conversations/direct-connections) | Point the client straight at your own OpenAI-compatible model endpoints, no server config required. |
+
+Each capability has its own page. Most people live in a plain **Chat** and reach for the others, a document here, a web search there, as the conversation calls for them.
diff --git a/docs/features/chat-conversations/memory.mdx b/docs/features/chat-conversations/memory.mdx
@@ -3,8 +3,20 @@ sidebar_position: 700
 title: "Memory & Personalization"
 ---
 
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
 # Memory & Personalization 🧠
 
+<ThemedImage
+  alt="Chat & Conversations map with the Memory cell highlighted"
+  sources={{
+    light: useBaseUrl('/images/banners/chat-conversations-memory-light.svg'),
+    dark: useBaseUrl('/images/banners/chat-conversations-memory-dark.svg'),
+  }}
+  style={{ width: '100%', margin: '0.25rem 0 1.75rem' }}
+/>
+
 :::warning Experimental Feature
 The Memory system is currently in **Beta/Experimental** stage. You may encounter inconsistencies in how models store or retrieve information, and storage formats may change in future updates.
 :::

diff --git a/docs/features/chat-conversations/rag/index.md b/docs/features/chat-conversations/rag/index.md
@@ -3,6 +3,18 @@ sidebar_position: 1
 title: "Retrieval Augmented Generation (RAG)"
 ---
 
+import ThemedImage from '@theme/ThemedImage';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+<ThemedImage
+  alt="Chat & Conversations map with the Documents (RAG) cell highlighted"
+  sources={{
+    light: useBaseUrl('/images/banners/chat-conversations-documents-light.svg'),
+    dark: useBaseUrl('/images/banners/chat-conversations-documents-dark.svg'),
+  }}
+  style={{ width: '100%', margin: '0.25rem 0 1.75rem' }}
+/>
+
 :::warning
 
 If you're using **Ollama**, note that it **defaults to a 2048-token context length**. This severely limits **Retrieval-Augmented Generation (RAG) performance**, especially for web search, because retrieved data may **not be used at all** or only partially processed.
@@ -254,7 +266,7 @@ These capabilities work independently, giving you fine-grained control:
 The togglable hybrid search sub-feature for our RAG embedding feature enhances RAG functionality via `BM25`, with re-ranking powered by `CrossEncoder`, and configurable relevance score thresholds. This provides a more precise and tailored RAG experience for your specific use case.
 
 :::tip Filesystem-style knowledge access (`kb_exec`)
-For an even more capable, agentic experience, set `ENABLE_KB_EXEC=True`. This gives the model a shell-style interface over your knowledge bases (`ls`, `tree`, `grep`, `cat`, `head`/`tail`, read-by-line, with pipes) that capable models tend to chain more reliably than a fan-out of separate search tools, so they locate the right passage more often. It requires **native function calling** (it is a native-mode builtin tool) and is off by default; in Default Mode it has no effect. We recommend turning it on for capable models. See [Filesystem-style access](/features/workspace/knowledge#filesystem-style-access-kb_exec).
+For an even more capable, agentic experience, set `ENABLE_KB_EXEC=True`. This gives the model a shell-style interface over your knowledge bases (`ls`, `tree`, `grep`, `cat`, `head`/`tail`, read-by-line, with pipes) that capable models tend to chain more reliably than a fan-out of separate search tools, so they locate the right passage more often. It requires **native function calling** (it is a native-mode builtin tool) and is off by default; for models set to Legacy it has no effect. We recommend turning it on for capable models. See [Filesystem-style access](/features/workspace/knowledge#filesystem-style-access-kb_exec).
 :::
 
 ## YouTube RAG Pipeline

diff --git a/docs/features/chat-conversations/web-search/_category_.json b/docs/features/chat-conversations/web-search/_category_.json
@@ -1,7 +1,4 @@
 {
 	"label": "Web Search",
-	"position": 600,
-	"link": {
-		"type": "generated-index"
-	}
+	"position": 600
 }