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 docs: Documents the knowledge base upload limits added as a global admin setting. 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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant