docs: document knowledge data storage limits for cloud plans

docs.json

@@ -214,7 +214,8 @@
                       },
                       "en/cloud/use-dify/knowledge/test-retrieval",
                       "en/cloud/use-dify/knowledge/integrate-knowledge-within-application",
-                      "en/cloud/use-dify/knowledge/knowledge-request-rate-limit"
+                      "en/cloud/use-dify/knowledge/knowledge-request-rate-limit",
+                      "en/cloud/use-dify/knowledge/knowledge-storage-limit"
                     ],
                     "icon": "book"
                   },
@@ -1605,7 +1606,8 @@
                       },
                       "zh/cloud/use-dify/knowledge/test-retrieval",
                       "zh/cloud/use-dify/knowledge/integrate-knowledge-within-application",
-                      "zh/cloud/use-dify/knowledge/knowledge-request-rate-limit"
+                      "zh/cloud/use-dify/knowledge/knowledge-request-rate-limit",
+                      "zh/cloud/use-dify/knowledge/knowledge-storage-limit"
                     ],
                     "icon": "book"
                   },
@@ -2996,7 +2998,8 @@
                       },
                       "ja/cloud/use-dify/knowledge/test-retrieval",
                       "ja/cloud/use-dify/knowledge/integrate-knowledge-within-application",
-                      "ja/cloud/use-dify/knowledge/knowledge-request-rate-limit"
+                      "ja/cloud/use-dify/knowledge/knowledge-request-rate-limit",
+                      "ja/cloud/use-dify/knowledge/knowledge-storage-limit"
                     ],
                     "icon": "book"
                   },

en/api-reference/openapi_service.json

@@ -5804,7 +5804,7 @@
                   "file": {
                     "type": "string",
                     "format": "binary",
-                    "description": "File to upload."
+                    "description": "File to upload, capped at 15 MB by default.\n\nSelf-hosted deployments adjust the limit with the `UPLOAD_FILE_SIZE_LIMIT` [environment variable](/en/self-host/deploy/configuration/environments). On Dify Cloud, Professional and Team plans raise the cap to 50 MB."
                   },
                   "data": {
                     "type": "string",
@@ -5988,6 +5988,23 @@
                 }
               }
             }
+          },
+          "413": {
+            "description": "`file_too_large` : The uploaded file exceeds the maximum size.",
+            "content": {
+              "application/json": {
+                "examples": {
+                  "file_too_large": {
+                    "summary": "file_too_large",
+                    "value": {
+                      "status": 413,
+                      "code": "file_too_large",
+                      "message": "File size exceeded."
+                    }
+                  }
+                }
+              }
+            }
           }
         },
         "x-mint": {
@@ -6714,7 +6731,7 @@
                   "file": {
                     "type": "string",
                     "format": "binary",
-                    "description": "File to upload."
+                    "description": "File to upload, capped at 15 MB by default.\n\nSelf-hosted deployments adjust the limit with the `UPLOAD_FILE_SIZE_LIMIT` [environment variable](/en/self-host/deploy/configuration/environments). On Dify Cloud, Professional and Team plans raise the cap to 50 MB."
                   },
                   "data": {
                     "type": "string",
@@ -7594,7 +7611,7 @@
                   "file": {
                     "type": "string",
                     "format": "binary",
-                    "description": "File to upload."
+                    "description": "File to upload, capped at 15 MB by default.\n\nSelf-hosted deployments adjust the limit with the `UPLOAD_FILE_SIZE_LIMIT` [environment variable](/en/self-host/deploy/configuration/environments). On Dify Cloud, Professional and Team plans raise the cap to 50 MB."
                   },
                   "data": {
                     "type": "string",
@@ -12139,7 +12156,7 @@
                   "file": {
                     "type": "string",
                     "format": "binary",
-                    "description": "The file to upload, as one `multipart/form-data` part."
+                    "description": "The file to upload, as one `multipart/form-data` part. Document files are capped at 15 MB by default.\n\nSelf-hosted deployments adjust the limit with the `UPLOAD_FILE_SIZE_LIMIT` [environment variable](/en/self-host/deploy/configuration/environments).\n\nOn Dify Cloud, Professional and Team plans raise the document cap to 50 MB. Images, audio, and video follow their own limits: 10 MB, 50 MB, and 100 MB by default."
                   }
                 }
               }
@@ -19446,4 +19463,4 @@
       }
     }
   }
-}
+}

en/cloud/use-dify/knowledge/create-knowledge/import-text-data/readme.mdx

@@ -12,13 +12,12 @@ When creating a ready-to-use knowledge base, you can upload local files as its d
 
 2. Select **Import from file** as the data source, then upload your files.
 
-    - Maximum number of files per upload: 5
+Upload limits vary by plan:
 
-    - Maximum file size: 15 MB
-
-    <Info>
-        Batch uploading (up to 50 files per upload) is available on <Badge color="blue">Professional</Badge> and <Badge color="blue">Team</Badge>. [Learn more](https://dify.ai/pricing).
-    </Info>
+| | Sandbox | Professional & Team |
+|:--|:--|:--|
+| Files per upload | 1 | 50 |
+| Size per file | 15 MB | 50 MB |
 
 ---
 

en/cloud/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx

@@ -21,6 +21,8 @@ The knowledge base offers two index methods: **High-Quality** and **Economical**
 
     Think of these vectors as coordinates in a multi-dimensional space—the closer two points are, the more similar their meanings. This allows the system to find relevant information based on semantic similarity, not just exact keyword matches.
 
+    These vectors count toward your workspace's knowledge storage. See [Knowledge Data Storage Limit](/en/cloud/use-dify/knowledge/knowledge-storage-limit) for per-plan capacity and what happens at the limit.
+
     <Tip>
       To enable cross-modal retrieval—retrieving both text and images based on semantic relevance—select a multimodal embedding model (marked with a **Vision** icon). Images extracted from documents will then be embedded and indexed for retrieval.
 

en/cloud/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx

@@ -76,9 +76,9 @@ Upload local files through drag-and-drop or file selection.
 
 | Item          | Description                                                                          |
 | ------------- | ------------------------------------------------------------------------------------ |
-| File Quantity | Maximum 50 files per upload                                                          |
-| File Size     | Each file must not exceed 15MB                                                       |
-| Storage       | Total document uploads and storage space vary by subscription plan                   |
+| File Quantity | 1 file per upload on Sandbox; up to 50 on Professional and Team                      |
+| File Size     | 15 MB per file; 50 MB on Professional and Team                                       |
+| Storage       | Total document count and knowledge storage vary by plan. |
 
 **Output Variables**
 

en/cloud/use-dify/knowledge/knowledge-storage-limit.mdx

@@ -0,0 +1,57 @@
+---
+title: Knowledge Data Storage Limit
+sidebarTitle: Data Storage Limit
+description: What counts toward your plan's knowledge storage, what happens when you reach the limit, and how to free space
+---
+
+Every document indexed with the **High Quality** [index method](/en/cloud/use-dify/knowledge/create-knowledge/setting-indexing-methods) stores its chunks as vectors (the numeric form that powers retrieval), and those vectors count toward your workspace's knowledge storage. 
+
+Each plan includes a fixed amount:
+
+| Plan | Storage |
+|:-----|:--------|
+| Sandbox | 50 MB |
+| Professional | 5 GB |
+| Team | 20 GB |
+
+The workspace owner and admins can check current usage in **Settings** > **Billing** > **Knowledge Data Storage**.
+
+## What Consumes Storage
+
+Usage depends on how many vectors your documents produce, not on their raw file size. The more chunks a document is split into, the more vectors it produces.
+
+<Info>
+In [Parent-child mode](/en/cloud/use-dify/knowledge/create-knowledge/chunking-and-cleaning-text), every child chunk becomes a vector.
+</Info>
+
+The embedding model matters too: each model outputs vectors of a fixed length, listed in the provider's documentation as its number of dimensions. For example, OpenAI's `text-embedding-3-large` uses nearly twice the storage per chunk of `text-embedding-3-small`.
+
+As a result, a document can use several times its own file size in storage once indexed.
+
+Documents indexed with the **Economical** method use keyword indexing instead of vectors and don't consume storage.
+
+Usage reflects the actual storage your vectors occupy, measured periodically, so a delay is expected before the number changes after an upload or deletion.
+
+## When an Upload Would Exceed the Limit
+
+Every upload is checked before indexing. When the estimated total storage after the upload would exceed your plan's capacity, the document is kept in the document list but not indexed.
+
+To bring it under the limit, split the file into smaller uploads, or raise the chunk size in the document's [chunk settings](/en/cloud/use-dify/knowledge/create-knowledge/chunking-and-cleaning-text) so it produces fewer chunks, though larger chunks make each retrieved passage longer and less precise. 
+
+Alternatively, upgrade your plan for more capacity, then try again.
+
+## When Storage Is Full
+
+Once usage reaches your plan's limit, the workspace can no longer add knowledge content.
+
+Uploading documents, adding or editing chunks, restoring archived documents, and re-indexing operations such as changing chunk settings are all blocked, including in knowledge bases that use **Economical** indexing. 
+
+To restore these actions, free space or upgrade your plan.
+
+If a downgrade or an expired subscription leaves your data above the new plan's limit, nothing is deleted: your apps can still retrieve from these knowledge bases, but adding content stays blocked until usage fits the limit or you upgrade again.
+
+## Free Up Storage
+
+Delete the documents or knowledge bases you no longer need. Their vectors are removed, and the space returns to your quota. 
+
+The usage shown in **Settings** > **Billing** refreshes on a delay, so the number takes a while to drop after a deletion.

ja/api-reference/openapi_service.json

@@ -5804,7 +5804,7 @@
                   "file": {
                     "type": "string",
                     "format": "binary",
-                    "description": "アップロードするファイルです。"
+                    "description": "アップロードするファイルです。デフォルトの上限は 15 MB です。\n\nセルフホスト環境では `UPLOAD_FILE_SIZE_LIMIT` [環境変数](/ja/self-host/deploy/configuration/environments) で調整できます。Dify Cloud の Professional と Team プランでは上限が 50 MB になります。"
                   },
                   "data": {
                     "type": "string",
@@ -5988,6 +5988,23 @@
                 }
               }
             }
+          },
+          "413": {
+            "description": "`file_too_large` : ファイルサイズが上限を超えています。",
+            "content": {
+              "application/json": {
+                "examples": {
+                  "file_too_large": {
+                    "summary": "file_too_large",
+                    "value": {
+                      "status": 413,
+                      "code": "file_too_large",
+                      "message": "File size exceeded."
+                    }
+                  }
+                }
+              }
+            }
           }
         },
         "x-mint": {
@@ -6714,7 +6731,7 @@
                   "file": {
                     "type": "string",
                     "format": "binary",
-                    "description": "アップロードするファイルです。"
+                    "description": "アップロードするファイルです。デフォルトの上限は 15 MB です。\n\nセルフホスト環境では `UPLOAD_FILE_SIZE_LIMIT` [環境変数](/ja/self-host/deploy/configuration/environments) で調整できます。Dify Cloud の Professional と Team プランでは上限が 50 MB になります。"
                   },
                   "data": {
                     "type": "string",
@@ -7594,7 +7611,7 @@
                   "file": {
                     "type": "string",
                     "format": "binary",
-                    "description": "アップロードするファイルです。"
+                    "description": "アップロードするファイルです。デフォルトの上限は 15 MB です。\n\nセルフホスト環境では `UPLOAD_FILE_SIZE_LIMIT` [環境変数](/ja/self-host/deploy/configuration/environments) で調整できます。Dify Cloud の Professional と Team プランでは上限が 50 MB になります。"
                   },
                   "data": {
                     "type": "string",
@@ -12139,7 +12156,7 @@
                   "file": {
                     "type": "string",
                     "format": "binary",
-                    "description": "アップロードするファイル。`multipart/form-data` の 1 パートとして送信します。"
+                    "description": "アップロードするファイル。`multipart/form-data` の 1 パートとして送信します。ドキュメントファイルのデフォルト上限は 15 MB です。\n\nセルフホスト環境では `UPLOAD_FILE_SIZE_LIMIT` [環境変数](/ja/self-host/deploy/configuration/environments) で調整できます。\n\nDify Cloud の Professional と Team プランではドキュメントの上限が 50 MB になります。画像・音声・動画ファイルには別の上限があり、デフォルトはそれぞれ 10 MB、50 MB、100 MB です。"
                   }
                 }
               }
@@ -19446,4 +19463,4 @@
       }
     }
   }
-}
+}

ja/cloud/use-dify/knowledge/create-knowledge/import-text-data/readme.mdx

@@ -14,14 +14,12 @@ title: ローカルファイルをアップロード
 
 2. データソースとして **既存テキストをインポート** を選択し、ファイルをアップロードします。
 
-    - 1 回のアップロードで選択できるファイル数の上限：5
-
-    - ファイルサイズの上限：15 MB
-
-    <Info>
-        バッチアップロード（1 回につき最大 50 ファイル）は <Badge color="blue">Professional</Badge> と <Badge color="blue">Team</Badge> で利用できます。[詳細](https://dify.ai/jp/pricing)。
-    </Info>
+アップロードの上限はプランによって異なります（[詳細](https://dify.ai/jp/pricing)）。
 
+| | Sandbox | Professional と Team |
+|:--|:--|:--|
+| 1 回あたりのファイル数 | 1 | 50 |
+| 1 ファイルあたりのサイズ | 15 MB | 50 MB |
 ---
 
 **アップロードファイル内の画像について**
@@ -39,7 +37,7 @@ title: ローカルファイルをアップロード
     - DOCX および XLSX ファイルに埋め込まれた画像
 
         <Tip>
-            その他のファイルタイプ（例：PDF）に埋め込まれた画像は、[ナレッジパイプライン](/ja/cloud/use-dify/knowledge/knowledge-pipeline/readme)で適切な文書抽出プラグインを使用して抽出できます。
+            その他のファイルタイプ（例：PDF）に埋め込まれた画像は、[ナレッジパイプライン](/ja/cloud/use-dify/knowledge/knowledge-pipeline/readme) で適切な文書抽出プラグインを使用して抽出できます。
         </Tip>
 
     - 任意のファイルタイプで、以下の Markdown 記法でアクセス可能な URL を介して参照される画像：

ja/cloud/use-dify/knowledge/create-knowledge/setting-indexing-methods.mdx

@@ -23,6 +23,8 @@ title: インデックス方法と検索設定を指定
 
     これらのベクトルは多次元空間上の座標のようなものです。2 つの点の距離が近いほど、それらの意味が近いことを示しています。このしくみにより、システムは単なるキーワード一致ではなく、意味的な類似性に基づいて関連情報を検索できます。
 
+    これらのベクトルはワークスペースのナレッジストレージを消費します。プランごとの容量と上限到達時の動作は [ナレッジベースのデータストレージ制限](/ja/cloud/use-dify/knowledge/knowledge-storage-limit) を参照してください。
+
     <Tip>
       クロスモーダル検索（テキストと画像を意味的関連性に基づいて取得）を有効にするには、マルチモーダル埋め込みモデル（**Vision** アイコン付き）を選択してください。ドキュメントから抽出された画像もベクトル化され、検索用にインデックス化されます。
 

ja/cloud/use-dify/knowledge/knowledge-pipeline/knowledge-pipeline-orchestration.mdx

@@ -79,9 +79,9 @@ title: ステップ 2：ナレッジパイプラインをオーケストレー
 
 | 項目         | 説明                                            |
 |--------------|-------------------------------------------------|
-| ファイル数    | 1 回あたり最大 50 ファイル                       |
-| ファイルサイズ | 1 ファイルあたり最大 15 MB                       |
-| ストレージ    | アップロード総数とストレージ容量はサブスクリプションプランによって異なります |
+| ファイル数    | Sandbox は 1 回につき 1 ファイル、Professional と Team は最大 50 ファイル |
+| ファイルサイズ | 1 ファイルあたり最大 15 MB（Professional と Team は 50 MB） |
+| ストレージ    | ドキュメント総数とナレッジストレージはプランによって異なる |
 
 **出力変数**