diff --git a/pages/docs/configuration/librechat_yaml/object_structure/_meta.ts b/pages/docs/configuration/librechat_yaml/object_structure/_meta.ts
index d72396679..b93cab907 100644
--- a/pages/docs/configuration/librechat_yaml/object_structure/_meta.ts
+++ b/pages/docs/configuration/librechat_yaml/object_structure/_meta.ts
@@ -7,6 +7,7 @@ export default {
   transactions: 'Transactions',
   balance: 'Balance',
   agents: 'Agents',
+  agents_config: 'Agents Settings (Global)',
   mcp_servers: 'MCP Servers',
   ocr: 'OCR',
   memory: 'Memory',
diff --git a/pages/docs/configuration/librechat_yaml/object_structure/agents_config.mdx b/pages/docs/configuration/librechat_yaml/object_structure/agents_config.mdx
new file mode 100644
index 000000000..cda6352da
--- /dev/null
+++ b/pages/docs/configuration/librechat_yaml/object_structure/agents_config.mdx
@@ -0,0 +1,35 @@
+# Agents Configuration (Global)
+
+The root-level `agents` configuration lets administrators control global behaviors for all LibreChat agents—independent of the per-endpoint options defined under `endpoints.agents`.
+
+## Example
+
+```yaml filename="agents"
+agents:
+  preventFileVersionHistory: true
+```
+
+## preventFileVersionHistory
+
+<OptionTable
+  options={[
+    [
+      'preventFileVersionHistory',
+      'Boolean',
+      'When `true`, attaching files to an agent (e.g., via File Search) no longer creates a new version snapshot of the agent. Defaults to `false` to preserve the previous behavior.',
+      'preventFileVersionHistory: true',
+    ],
+  ]}
+/>
+
+**Why disable versioning for file uploads?**
+
+- Prevents the `versions` array from growing uncontrollably when agents ingest large document sets.
+- Avoids hitting MongoDB's 16 MB document limit for heavily-used agents.
+- Still keeps existing agent state and metadata intact—the setting only skips automatic version snapshots for file attachment updates.
+
+**Notes**
+
+- Applies to all agent file attachments, including File Search/RAG uploads.
+- You can still manually capture versions by editing other agent attributes (instructions, tools, etc.).
+- Disable this flag if you rely on version history to revert individual file uploads.
diff --git a/pages/docs/configuration/librechat_yaml/object_structure/config.mdx b/pages/docs/configuration/librechat_yaml/object_structure/config.mdx
index 51635aa58..2c7133085 100644
--- a/pages/docs/configuration/librechat_yaml/object_structure/config.mdx
+++ b/pages/docs/configuration/librechat_yaml/object_structure/config.mdx
@@ -359,6 +359,34 @@ see also:
 - [alloweddomains](/docs/configuration/librechat_yaml/object_structure/actions#alloweddomains),
 - [Actions Object Structure](/docs/configuration/librechat_yaml/object_structure/actions)
 
+## agents
+
+**Key:**
+<OptionTable
+  options={[
+    [
+      'agents',
+      'Object',
+      'Configures global agent behavior that applies to every agent regardless of endpoint settings.',
+      '',
+    ],
+  ]}
+/>
+
+**Subkeys:**
+<OptionTable
+  options={[
+    [
+      'preventFileVersionHistory',
+      'Boolean',
+      'When true, uploading/attaching files to an agent no longer creates a new agent version snapshot. Use this to prevent version-history bloat for RAG/File Search heavy agents. Default: false.',
+      'preventFileVersionHistory: true',
+    ],
+  ]}
+/>
+
+see: [Agents Configuration (Global)](/docs/configuration/librechat_yaml/object_structure/agents_config)
+
 ## interface
 
 **Key:**