diff --git a/organize/navigation.mdx b/organize/navigation.mdx index 27ea5cc95..f94b015e8 100644 --- a/organize/navigation.mdx +++ b/organize/navigation.mdx @@ -319,6 +319,55 @@ In the `navigation` object, `dropdowns` is an array where each entry is an objec } ``` +## Products + +Products create a dedicated navigation division for organizing product-specific documentation. Use products to separate different offerings, services, or major feature sets within your documentation. + +In the `navigation` object, `products` is an array where each entry is an object that requires a `product` field and can contain other navigation fields such as groups, pages, icons, or links to external pages. + +```json +{ + "navigation": { + "products": [ + { + "product": "Core API", + "icon": "api", + "groups": [ + { + "group": "Getting started", + "pages": [ + "core-api/quickstart", + "core-api/authentication" + ] + }, + { + "group": "Endpoints", + "pages": [ + "core-api/users", + "core-api/orders" + ] + } + ] + }, + { + "product": "Analytics Platform", + "icon": "chart-bar", + "pages": [ + "analytics/overview", + "analytics/dashboard", + "analytics/reports" + ] + }, + { + "product": "Mobile SDK", + "icon": "smartphone", + "href": "https://mobile-sdk-docs.example.com" + } + ] + } +} +``` + ## OpenAPI Integrate OpenAPI specifications directly into your navigation structure to automatically generate API documentation. Create dedicated API sections or place endpoint pages within other navigation components. @@ -463,7 +512,7 @@ For automated translations, [contact our sales team](mailto:gtm@mintlify.com) to ## Nesting -You can use any combination of anchors, tabs, and dropdowns. The components can be nested within each other interchangeably to create your desired navigation structure. +You can use any combination of anchors, tabs, dropdowns, and products. The components can be nested within each other interchangeably to create your desired navigation structure.