/admin/chat-preferences).
These defaults apply to all users unless a user overrides them in their personal settings.
The page is available in all editions.

Chat Settings
- Default Language: UI language for users who have not set one in their own settings.
- Chat Naming Model: The model that generates chat session titles. A fast, low-cost model works well. Choose Chat Default to use the default chat model.
- Multi-Model Generation: Lets users run several models in parallel on the same message.
- Deep Research: Agentic research across the web and connected sources. It uses many more tokens per query than normal chat.
- Chat Auto-Scroll: Scrolls the chat view to new content while the model generates a response. Users can override this in their personal settings.

Search Settings
- Search Selection Model: The model that selects and checks retrieved documents. A fast, low-cost model reduces search cost but can affect answer quality.
- Search Mode: A quick document search view across your organization. It is available on Business and higher plans and on Onyx Cloud. The switch is disabled until you add at least one connector.
- Auto-Detect Search Filters: Applies source and time filters that Onyx infers from the query, for example “in Slack” or “last quarter”.
Team Information
- Team Name: Added to every chat as extra context, for example your team or company name.
- Team Context: A short description of your team or company. Onyx adds it next to the team name.
Users can add their own context in personal settings on top of these organization-level fields.

System Prompt
The system prompt is the base instruction set for chats, Agents, and projects. The full default system prompt:Onyx expands these placeholders at run time:
{{CURRENT_DATETIME}}inserts the current date and day of the week.{{CITATION_GUIDANCE}}adds citation instructions when a search tool retrieved facts. It is empty otherwise.{{REMINDER_TAG_DESCRIPTION}}explains how to read system reminders in user messages.
Connectors
This section lists the sources that Internal Search uses in the default chat. See Connectors for setup details.Actions & Tools
Turn on the tools that the default chat can use:- Internal Search: Searches your connected sources.
- Image Generation: Needs an image model. Configure it on the Image Generation page first.
- Web Search: Searches the web. Configure a provider on the Web Search page.
- Open URL: Reads the content of a URL that a user pastes.
- Code Interpreter: Writes and runs code. See Code Interpreter.
- Coding Agent: Delegates coding tasks to a coding agent.
These settings do not apply to Agents.
Configure knowledge and tools for each Agent on its own page.

Advanced Options

Keep Chat History
Set how long Onyx keeps chats for your organization. Choose Forever, a preset period, or Custom. This setting needs an Enterprise plan or Onyx Cloud.Query History Visibility
Set what admins see on the Query History page: Show with User Info, Anonymized, or Hidden.File Attachment Size Limit
Files attached in chats and projects must fit within both limits:- File Size Limit (MB): Maximum size per file. The default is 100 MB. The page shows the upper bound,
250 MB by default. Self-hosted operators can change it with
MAX_ALLOWED_UPLOAD_SIZE_MB. - File Token Limit (thousand tokens): Maximum tokens per file. The default is 200. Leave it empty for no limit.
Larger files increase latency, memory use, and token cost.
Large text files such as CSVs can stay under the size limit but exceed the token limit.
Allow Anonymous Users
When on, visitors can start chats without signing in. Anonymous users see only their own chats. They cannot create Agents or change settings. Their chats use your models and count toward usage and cost.Always Start with an Agent
When on, Onyx removes the default chat. Users always start in an Agent, and new chats open in their last active Agent.This mode disables the Connectors and Actions & Tools sections on this page.
Configure knowledge and tools on each Agent instead.