diff --git a/content/docs/configuration/librechat_yaml/object_structure/interface.mdx b/content/docs/configuration/librechat_yaml/object_structure/interface.mdx
index 554453bd9..1101dce3c 100644
--- a/content/docs/configuration/librechat_yaml/object_structure/interface.mdx
+++ b/content/docs/configuration/librechat_yaml/object_structure/interface.mdx
@@ -1212,20 +1212,25 @@ 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:**
**Sub-keys:**
**Default:**
@@ -1242,3 +1247,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:**
+
+
+**Sub-keys:**
+
+
+
+**`list` item sub-keys:**
+
+
+
+**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.