Create multiple content variations within a single tab using the new variants feature. This allows you to show different perspectives, user types, or implementation approaches for the same topic without creating separate tabs.
You can now define variants for tabs with different layouts, titles, subtitles, and icons. Each variant can have its own navigation structure, and you can explicitly set which variant should be the default.
You can use your own image files as icons throughout your docs.yml navigation config, including for navbar link, section, page, and product icons.
Icons support three formats:
fa-solid fa-seedling or fa-regular fa-leaf. Pro and Brand icons from Font Awesome are supported../assets/icons/plant-icon.svg). Paths are relative to the YAML file where the icon is referenced (e.g., docs.yml).You can now configure products to link to external URLs (separate applications, third-party documentation, or other external resources) instead of documentation within your site.
External products appear in the product switcher alongside internal products but navigate users to the specified URL when selected. Unlike internal products, external products are defined directly in docs.yml using href—no standalone product .yml file is needed.
To define an external product, add an item to the products list in docs.yml with an href instead of a path: