Category Metadata
1 min read
Category metadata (name, description, icon) lives in opencx.json under the optional categories key. Each key is the category path relative to content_dir (e.g. getting-started, advanced/configuration). The value is an object with name (required), and optional description and icon.
Format
In opencx.json:
json
{
"categories": {
"getting-started": { "name": "Getting Started" },
"billing": {
"name": "Billing & Payments",
"description": "Invoices, subscriptions, and payment methods",
"icon": "credit-card"
}
}
}
Fields (per category)
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Display name for the category |
description | string | No | A short summary of the category |
icon | string | No | Icon identifier for the category |
Fallback
When a category path is not listed in categories, the display name is derived from the directory name: split on hyphens and capitalize each word.
| Directory Name | Derived Name |
|---|---|
getting-started | Getting Started |
api-reference | Api Reference |
billing | Billing |
Updating categories
Running opencx content pull updates categories in opencx.json from the remote help center. You can also edit opencx.json by hand.