From 4982a2b0668841215c0ea445d9c9a03e8d347aad Mon Sep 17 00:00:00 2001
From: "eduardo.guedes" <eduardo.guedes@opus-software.com.br>
Date: Mon, 25 May 2026 16:27:41 -0300
Subject: [PATCH] docs: document `interface.marketplace.categories`

---
 .../object_structure/interface.mdx            | 50 ++++++++++++++++++-
 1 file changed, 48 insertions(+), 2 deletions(-)

diff --git a/content/docs/configuration/librechat_yaml/object_structure/interface.mdx b/content/docs/configuration/librechat_yaml/object_structure/interface.mdx
index f3f851650..2e2206c5f 100644
--- a/content/docs/configuration/librechat_yaml/object_structure/interface.mdx
+++ b/content/docs/configuration/librechat_yaml/object_structure/interface.mdx
@@ -685,14 +685,14 @@ interface:
 
 ## marketplace
 
-Enables/disables access to the Agent Marketplace.
+Enables/disables access to the Agent Marketplace and, optionally, defines custom categories used to organize agents within it.
 
 > **Deprecated for permission management.** Seeds the `MARKETPLACE` role permission at startup for the default `USER` role only. Prefer the [Admin Panel](/docs/features/admin_panel).
 
 **Key:**
 <OptionTable
   options={[
-    ['marketplace', 'Object', 'Configuration for Agent Marketplace access control.'],
+    ['marketplace', 'Object', 'Configuration for Agent Marketplace access control and custom categories.'],
   ]}
 />
 
@@ -701,6 +701,7 @@ Enables/disables access to the Agent Marketplace.
 <OptionTable
   options={[
     ['use', 'Boolean', 'Enables or disables marketplace access. Default: false'],
+    ['categories', 'Object', 'Optional. Configures default and custom marketplace categories. Only applied when use is true. See below.'],
   ]}
 />
 
@@ -716,3 +717,48 @@ interface:
   marketplace:
     use: true  # Enable marketplace access
 ```
+
+### categories
+
+Customizes the categories displayed in the Agent Marketplace. The list is synced to the database on startup: new entries are created, existing entries are updated, and custom entries removed from the YAML are deleted from the database. Categories are only synced when `marketplace.use` is `true`.
+
+**Key:**
+<OptionTable
+  options={[
+    ['categories', 'Object', 'Configuration for marketplace categories. Synced to the database on startup.'],
+  ]}
+/>
+
+**Sub-keys:**
+
+<OptionTable
+  options={[
+    ['enableDefaultCategories', 'Boolean', "When true, LibreChat's built-in default categories are kept active and appear before custom categories. Default: true"],
+    ['list', 'Array of Objects', 'Ordered list of custom categories. The declared order is preserved in the marketplace UI (after default categories when enableDefaultCategories is true).'],
+  ]}
+/>
+
+**`list` item sub-keys:**
+
+<OptionTable
+  options={[
+    ['value', 'String', 'Display name for the category. Stored lowercase internally and treated case-insensitively when matching existing categories.'],
+    ['description', 'String', 'Short description shown alongside the category in the marketplace.'],
+  ]}
+/>
+
+**Example:**
+```yaml filename="interface / marketplace / categories"
+interface:
+  marketplace:
+    use: true
+    categories:
+      enableDefaultCategories: true  # Built-in categories appear first
+      list:                          # Order here determines marketplace order
+        - value: "Education"
+          description: "Educational agents."
+        - value: "Productivity"
+          description: "Productivity agents."
+```
+
+> **Note:** Removing a custom category from `list` deletes it from the database on the next startup. Default categories are never deleted, `enableDefaultCategories: false` only hides them.