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.