# What changed in docusaurus-plugin-openapi-docs

> 5 changes in docusaurus-plugin-openapi-docs 5 from its official release notes, upgrade guides and advisories: 2 new APIs and options. Each one cited. Sources checked 2026-10-25. HTML: https://unstale.sh/npm/docusaurus-plugin-openapi-docs/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## docusaurus-plugin-openapi-docs 5

### New APIs and options

- The sidebar can now be grouped by tagParent using groupPathsBy, enabling nested tag hierarchies. (5.2.0) — [release notes](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/blob/3fa700828352a2380abd9d93337340475bc322fa/CHANGELOG.md#520-2026-08-11)
- 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. (5.2.0) — [release notes](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/blob/3fa700828352a2380abd9d93337340475bc322fa/CHANGELOG.md#520-2026-08-11)

### Fixes and other changes

- Renders additionalProperties correctly inside discriminator map variants. (5.1.3) — [release notes](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/blob/3fa700828352a2380abd9d93337340475bc322fa/CHANGELOG.md#513-2026-07-30)
- Prevents infinite recursion that could freeze operation pages when each oneOf branch declares its own self-referential discriminator. (5.1.3) — [release notes](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/blob/3fa700828352a2380abd9d93337340475bc322fa/CHANGELOG.md#513-2026-07-30)
- Branch properties are no longer duplicated across sibling branches when rendering nested anyOf/oneOf schemas. (5.1.2) — [release notes](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs/blob/3fa700828352a2380abd9d93337340475bc322fa/CHANGELOG.md#512-2026-07-10)