Skip to content

docs: document knowledge data storage limits for cloud plans - #935

Open
RiskeyL wants to merge 5 commits into
mainfrom
docs/knowledge-storage-limit
Open

docs: document knowledge data storage limits for cloud plans#935
RiskeyL wants to merge 5 commits into
mainfrom
docs/knowledge-storage-limit

Conversation

@RiskeyL

@RiskeyL RiskeyL commented Aug 7, 2026

Copy link
Copy Markdown
Contributor

What this adds

Prepared ahead of the Cloud rollout of pre-write vector storage estimation and the paid-plan document size raise. Hold merge until both are live on Cloud.

New page: Knowledge Data Storage Limit ({en,zh,ja}/cloud/use-dify/knowledge/knowledge-storage-limit)

  • Per-plan storage quotas (50 MB / 5 GB / 20 GB) and where to check usage
  • What consumes storage: chunk count and embedding dimensions, not raw file size; Economical indexing exempt
  • The pre-upload estimation check and how to bring a rejected upload under the limit
  • Blocked actions at the limit, plus downgrade/expiry behavior (existing data retained, retrieval keeps working, new writes blocked — confirmed with R&D)
  • Freeing space and the usage refresh delay
  • Cross-linked from the index method page's High Quality tab

Plan-based upload limits on existing pages

  • Upload Local Files: limits presented per plan in a table (Sandbox 1 file / 15 MB; paid 50 files / 50 MB). The old "5 files per upload" claim is corrected — the Sandbox batch limit is 1, enforced in code today
  • Knowledge Pipeline Orchestration: File Quantity / File Size / Storage rows updated to per-plan values

Service API specs (en/zh/ja)

  • Per-plan document file size limits on the four knowledge file endpoints; pipeline file-upload keeps the separate media limits (10/50/100 MB)
  • file_too_large 413 documented on Create Document by File (the create path returns 413 with this feature; current main returns 400)

Glossary: Knowledge Data Storage UI label row, termbase synced.

Close DC-154

Copilot AI lite review requested due to automatic review settings August 7, 2026 08:57
@dosubot dosubot Bot added size:L This PR changes 100-499 lines, ignoring generated files. documentation Improvements or additions to documentation labels Aug 7, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds Cloud documentation for plan-based knowledge vector storage quotas and upload limits, and aligns the Service API reference plus glossary/termbase terminology ahead of the Cloud rollout.

Changes:

  • Add a new “Knowledge Data Storage Limit” page (en/zh/ja) describing per-plan quotas, what consumes storage, and limit behaviors.
  • Update existing Knowledge pages (en/zh/ja) to reflect plan-based upload limits and link to the new storage-limit page.
  • Update Service API specs (en/zh/ja) to document per-plan file size caps and a file_too_large 413 response; sync glossary/termbase and navigation.

Reviewed changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
zh/cloud/use-dify/knowledge/knowledge-storage-limit.mdx New Chinese page describing knowledge storage quotas and limit behavior.
ja/cloud/use-dify/knowledge/knowledge-storage-limit.mdx New Japanese page describing knowledge storage quotas and limit behavior.
en/cloud/use-dify/knowledge/knowledge-storage-limit.mdx New English source page for knowledge storage quotas and limit behavior.
zh/cloud/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx Updates pipeline limitations table to plan-based quotas/limits (with one terminology consistency nit).
ja/cloud/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx Updates pipeline limitations table to plan-based quotas/limits.
en/cloud/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx Updates pipeline limitations table to plan-based quotas/limits.
zh/cloud/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx Adds cross-link noting vectors count toward knowledge storage with link to the new page.
ja/cloud/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx Adds cross-link noting vectors count toward knowledge storage with link to the new page.
en/cloud/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx Adds cross-link noting vectors count toward knowledge storage with link to the new page.
zh/cloud/use-dify/knowledge/create-knowledge/import-text-data/readme.mdx Replaces old upload limit claims with a per-plan table (needs a blank line before ---).
ja/cloud/use-dify/knowledge/create-knowledge/import-text-data/readme.mdx Replaces old upload limit claims with a per-plan table (needs a blank line before ---).
en/cloud/use-dify/knowledge/create-knowledge/import-text-data/readme.mdx Replaces old upload limit claims with a per-plan table.
zh/api-reference/openapi_service.json Documents file-size caps and adds file_too_large 413 example for the document-by-file create path.
ja/api-reference/openapi_service.json Documents file-size caps and adds file_too_large 413 example for the document-by-file create path.
en/api-reference/openapi_service.json Documents file-size caps and adds file_too_large 413 example for the document-by-file create path.
writing-guides/glossary.md Adds UI glossary row for “Knowledge Data Storage”.
tools/translate/termbase_i18n.md Syncs termbase row for “Knowledge Data Storage”.
docs.json Adds the new page to navigation for en/zh/ja Knowledge sections.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants