{"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"products","__idx":0},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}]},{"$$mdtype":"Tag","name":"ConfigOptionRequirements","attributes":{"products":["Revel","Realm"],"plans":["Pro","Enterprise","Enterprise+"]},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}," section to set up multiple product documentation sets in your project."," ","This option configuration creates a product picker in the navbar and offers the ability to customize the look of each product's documentation set."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/content-assets/product-picker-19c445a1c7ac9dd2.png","alt":"Screenshot with product picker in navbar","framed":true,"withLightbox":true},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"options","__idx":1},"children":["Options"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["products"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Map[string, ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"#product-object"},"children":["Product"]},"]"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REQUIRED."]}," ","Map of strings allows for the definition of multiple products."," ","Strings represent product only in configuration file - they do not appear in published product."," ","Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["acme-us"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"product-object","__idx":2},"children":["Product object"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REQUIRED."]}," ","Name of the product that appears in product picker."," ","Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Acme"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["icon"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Path to the product icon file."," ","Displays next to the product name in product picker."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["folder"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REQUIRED."]}," ","Path to the product content folder."," ","Cannot be a subfolder in another product's folder."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"examples","__idx":3},"children":["Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"basic-multi-product-setup","__idx":4},"children":["Basic multi-product setup"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example shows a simple multi-product configuration:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","data-title":"redocly.yaml","header":{"title":"redocly.yaml","controls":{"copy":{}}},"source":"products:\n  acme:\n    name: Acme\n    folder: products/acme/\n  museum:\n    name: Museum\n    folder: products/museum/\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"complete-multi-product-configuration","__idx":5},"children":["Complete multi-product configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example shows a comprehensive multi-product setup with icons and proper folder structure:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","data-title":"redocly.yaml","header":{"title":"redocly.yaml","controls":{"copy":{}}},"source":"products:\n  platform:\n    name: Platform API\n    icon: images/platform-icon.svg\n    folder: products/platform/\n  mobile:\n    name: Mobile SDK\n    icon: images/mobile-icon.svg\n    folder: products/mobile/\n  integrations:\n    name: Integrations\n    icon: images/integrations-icon.svg\n    folder: products/integrations/\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This configuration creates a product picker in the navbar and organizes content as follows:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"treeview","header":{"controls":{"copy":{}}},"source":"project/\n├── images/\n│   ├── platform-icon.svg\n│   ├── mobile-icon.svg\n│   └── integrations-icon.svg\n├── products/\n│   ├── platform/\n│   │   ├── index.md\n│   │   ├── api-reference.yaml\n│   │   └── redocly.yaml        # Optional product-specific config\n│   ├── mobile/\n│   │   ├── index.md\n│   │   ├── guides/\n│   │   └── sidebars.yaml       # Product-specific navigation\n│   └── integrations/\n│       ├── index.md\n│       └── webhooks.yaml\n├── index.md                    # Project landing page\n└── redocly.yaml               # Main configuration\n","lang":"treeview"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"product-specific-configuration","__idx":6},"children":["Product-specific configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each product folder can include its own ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redocly.yaml"]}," file to customize that product's documentation."," ","Product-specific configurations override the root configuration for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["breadcrumbs"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["codeSnippet"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["feedback"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["footer"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["logo"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["navbar"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["sidebar"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["search"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["mockServer"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","data-title":"products/platform/redocly.yaml","header":{"title":"products/platform/redocly.yaml","controls":{"copy":{}}},"source":"# Platform-specific customization\nnavbar:\n  items:\n    - page: index.md\n      label: Platform Overview\n    - page: api-reference.yaml\n      label: API Reference\n    - page: guides/index.md\n      label: Platform Guides\n\nfooter:\n  copyrightText: \"© 2024 Platform Team. All rights reserved.\"\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"search-behavior-in-multi-product","__idx":7},"children":["Search behavior in multi-product"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When users search from a product page, results are automatically filtered to that product."," ","Users can remove the filter to search all content."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"hide-the-product-picker","__idx":8},"children":["Hide the product picker"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To hide the product picker globally:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add the following code to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@theme/styles.css"]},":"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"css","header":{"controls":{"copy":{}}},"source":"[data-component-name=\"Product/ProductPicker\"] {\n  display: none;\n}\n","lang":"css"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resources","__idx":9},"children":["Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/navigation/multi-product"},"children":["Multi-product"]}]}," - Conceptual guide to multi-product documentation including product switching and organization strategies"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/navigation"},"children":["Build navigation"]}]}," - Configure navigation elements and structures for multi-product sites with product-specific navigation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/branding/customize-styles#style-products-individually"},"children":["Style products individually"]}]}," - Add custom styling to individual products"]}]}]},"frontmatter":{"products":["Revel","Realm"],"plans":["Pro","Enterprise","Enterprise+"],"description":"Set up multiple product documentation sets in your project."},"tagList":["configOptionRequirements","img","table"],"title":"products","lastModified":"2026-10-01T23:00:57.000Z"}