Skip to content

docs: Documents the knowledge base upload limits added as a global admin setting. - #1342

Draft
rbx wants to merge 1 commit into
open-webui:devfrom
rbx:kb-limits-docs
Draft

docs: Documents the knowledge base upload limits added as a global admin setting.#1342
rbx wants to merge 1 commit into
open-webui:devfrom
rbx:kb-limits-docs

Conversation

@rbx

@rbx rbx commented Aug 4, 2026

Copy link
Copy Markdown

Documents the knowledge base upload limits added as a global admin setting.

Corresponding open-webui PR: open-webui/open-webui#28142

Changes

  • docs/features/workspace/knowledge.mdx — new "Knowledge base upload limits" section under Limitations: what the limits do, 0/empty = unlimited, that they're global (apply to every knowledge base and every user, including admins, with no per-user or per-group override), and that enforcement is server-side across every upload path (manual button, one-shot directory import, incremental sync, and the API).
  • docs/reference/env-configuration.mdx — adds RAG_KNOWLEDGE_MAX_SIZE and RAG_KNOWLEDGE_MAX_COUNT entries, alongside the existing RAG_FILE_MAX_SIZE / RAG_FILE_MAX_COUNT entries they're modeled on.
  • docs/troubleshooting/rag.mdx — updates the existing "Upload Limits and Restrictions" section, which previously documented knowledge base uploads as having no count limit at all.

Related

  • Discussions: open-webui/discussions#24075, open-webui/discussions#24845
Documents the RAG_KNOWLEDGE_MAX_COUNT / RAG_KNOWLEDGE_MAX_SIZE global
admin settings, which cap how many files a knowledge base may hold
and how large each file may be. Configurable in Admin Panel →
Settings → Documents → Files, alongside the existing Max Upload Size
/ Max Upload Count fields. Applies globally to every knowledge base
and every user (no per-user or per-group override), and is enforced
for every way of adding a file to a knowledge base: manual upload,
one-shot directory import, incremental directory sync, and the API.

- docs/features/workspace/knowledge.mdx: new "Knowledge base upload
  limits" section under Limitations.
- docs/reference/env-configuration.mdx: RAG_KNOWLEDGE_MAX_SIZE /
  RAG_KNOWLEDGE_MAX_COUNT entries, alongside RAG_FILE_MAX_SIZE /
  RAG_FILE_MAX_COUNT.
- docs/troubleshooting/rag.mdx: updates the existing "Upload Limits
  and Restrictions" section, which previously documented knowledge
  base uploads as having no count limit at all.
@rbx
rbx force-pushed the kb-limits-docs branch from 06cdf7d to a032186 Compare August 5, 2026 08:06
@rbx rbx changed the title docs: Document the per-group/per-user knowledge base upload limits Aug 5, 2026
@rbx
rbx marked this pull request as ready for review August 5, 2026 08:32
@Classic298
Classic298 marked this pull request as draft August 7, 2026 18:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant