Skip to main content

Channels

Channels: a shared #product-launch channel where people and AI models talk in one timeline, summoned with @model mentionsChannels: a shared #product-launch channel where people and AI models talk in one timeline, summoned with @model mentions

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.

Open WebUI is where knowledge is found, created, and shared. Channels make that collaborative.


Why Channels?

AI as a participant, not a separate tool

Tag @gpt-4o to draft a plan, then tag @claude to critique it. Your whole team sees both responses in the same timeline with full context. No tab-switching, no copy-pasting between tools.

Persistent shared context

Every message becomes part of the record. When someone asks a question next week, the AI can draw on everything discussed before. Channels are living knowledge bases, not disposable threads.

Multiple models, one conversation

Use one model for code review, another for writing, a third for data analysis, all in the same channel. Chain them together for richer answers than any single model could produce.

Real-time collaboration

Instant updates, emoji reactions, threaded replies, pinned messages, and unread indicators.


Key Features

🤖 @model taggingSummon any AI model into the conversation on demand
👥 Shared contextEvery message, human or AI, builds the collective knowledge
🧵 Threads & reactionsKeep discussions organized with replies, pins, and emoji reactions
📎 File sharingDrop images, documents, and code. AI can see and process them
🔒 Access controlPublic, private, group-based, and direct message channels
🧠 AI channel awarenessModels can search and synthesize across channels autonomously

Channel Types

TypeBest for
StandardTopic-based rooms (#engineering, #marketing-strategy), public or private
GroupTeam-scoped spaces with explicit membership and user-group sync
Direct MessagePrivate 1:1 or small-group conversations with online/offline status

How It Works

Talking to AI

Channels are passive by default. AI doesn't jump into every conversation. When you need input from a model, just tag it:

You: @gpt-4o Here's our Q3 revenue data. What trends stand out?

(GPT-4o analyzes the data and responds with key insights)

You: @claude Do you agree with that analysis? What's missing?

This means your team can discuss freely without AI interrupting, and call on exactly the right model when it's needed.

Where the reply appears

By default a model answering a top-level mention replies in a thread under your message, so a long answer does not push the channel's conversation off the screen. An administrator can change this in Settings > Admin > General (Model Response Mode, or CHANNEL_MODEL_RESPONSE_MODE): set it to Channel and the reply is posted into the timeline instead, where the team reads it without opening a thread. Mentioning a model from inside a thread always answers in that thread either way.

Full chat-completion pipeline

Mentioning a model in a channel runs through the same chat-completion pipeline as a standard chat. The reply is streamed in real time as the model generates it, and the model has access to the full set of capabilities its configuration grants:

CapabilityWhat it enables in a channel
Native and default function callingTool calls resolve and execute mid-message
Built-in toolsWeb search, image generation, code interpreter, calendar
User tools and MCP toolsWhatever the model is configured to call, it can call
FiltersInlet/outlet/stream filters apply just like in chats
Knowledge (RAG)Knowledge bases attached to the model are queried and injected
Attached documentsImages and non-image files (PDF, DOCX, etc.) uploaded in the thread are forwarded into the model's context
Structured repliesThe reply is rendered from the model's full output, so reasoning blocks, tool calls, generated images and code results appear in the channel as they do in a chat, rather than being flattened to plain text

In other words, a channel-summoned model is a fully-equipped agent, not a one-shot completion.

Document attachments in channels (v0.9.6+)

Before v0.9.6, tagging a model in a channel only forwarded images from the thread. Uploaded PDFs, DOCX, and other non-image documents were ignored, so summarization and document-comparison prompts silently had nothing to work with. As of v0.9.6 these files are forwarded the same way they are in a direct chat, so document workflows behave identically in channels.

Tagging people and linking channels

Use @username to notify teammates. Use #channel-name to create clickable cross-references between conversations.

Message interactions

Hover any message to react with emoji, pin it for reference, reply inline, or start a threaded side conversation.


AI Channel Awareness

With native function calling enabled, models can navigate your channels autonomously:

  • Search channels by name or description
  • Search messages across all accessible channels
  • Read threads to understand full discussion context

You: What was decided in #dev-team about the migration timeline?

(The AI searches the channel, reads the relevant thread, and gives you a synthesized answer, all without you leaving your current chat.)

This removes the need to manually bridge information between private chats and shared channels. The AI does it for you.

Community action: Forward to Channel

If you want a one-click path from a chat message into a channel, the community Forward to Channel action adds a button to each assistant message that posts the reply (or a selection) into a channel of your choice. Useful for promoting good answers from private chats into team-visible spaces without copy-paste.


Getting Started

info

Channels must be enabled by an administrator before use.

  1. Navigate to Settings > Admin > System > General
  2. Toggle Channels on and save
  3. Channels appear in the sidebar. Click (+) to create your first one

Channel creation is restricted to administrators by default. Channels support granular permissions including read-only access, write access, and feature-level toggles via environment variables or group permissions.


Use Cases

Team knowledge hub (#engineering)

Your team discusses architecture decisions throughout the week. Someone tags @claude to evaluate tradeoffs. The AI's analysis becomes part of the permanent record: searchable, referenceable, and available to every future conversation in that channel.

Multi-model war room (#incident-response)

Paste logs and error traces. Tag @gpt-4o to analyze the stack trace. Tag @deepseek-coder to suggest a fix. Tag @claude to draft the postmortem. Three models, one shared context, one timeline.

Project strategy (#product-launch)

Twenty messages of human brainstorming. Then: @gpt-4o Read the conversation above and create a prioritized action plan with owners and deadlines. The AI synthesizes everything discussed into a structured deliverable.

Creative collaboration (#story-mode)

Long-running narrative projects where multiple "character" models interact in the same timeline. Switch between personas without losing context.


Privacy

Public channels are visible to all users on your instance. Do not share API keys, passwords, or sensitive data in public channels.

This content is for informational purposes only and does not constitute a warranty, guarantee, or contractual commitment. Open WebUI is provided "as is." See your license for applicable terms.