npm / docusaurus-plugin-openapi-docs
docusaurus-plugin-openapi-docs
What changed in docusaurus-plugin-openapi-docs 5, from its official release notes, upgrade guides and advisories. Also covers docusaurus-theme-openapi-docs. Sources checked 2026-10-25.
2 new APIs and options3 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initdocusaurus-plugin-openapi-docs 55 changes
New APIs and options 2
The sidebar can now be grouped by tagParent using groupPathsBy, enabling nested tag hierarchies.
OpenAPI 3.2 tag definitions can use parent to build nested tag hierarchies, which can be used to group the sidebar by tagParent via groupPathsBy.
Fixes and other changes 3
Renders additionalProperties correctly inside discriminator map variants.
Prevents infinite recursion that could freeze operation pages when each oneOf branch declares its own self-referential discriminator.
Branch properties are no longer duplicated across sibling branches when rendering nested anyOf/oneOf schemas.