# What changed in @radix-ui/react-navigation-menu

> 15 changes in @radix-ui/react-navigation-menu 1 from its official release notes, upgrade guides and advisories: 1 breaking, 4 new APIs and options. Each one cited. Sources checked 2026-10-20. HTML: https://unstale.sh/npm/@radix-ui/react-navigation-menu/

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

## @radix-ui/react-navigation-menu 1

### Breaking changes

- Active content now renders inside the consumer's element alongside its existing children, rather than replacing them. (1.3.0) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#130)

### New APIs and options

- Added a prop to choose automatic or manual trigger activation; automatic remains the default. (1.3.0) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#130)
- Added a prop to choose automatic or manual trigger activation; when omitted, the submenu inherits the parent root's value. (1.3.0) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#130)
- Added a prop controlling whether clicking an already-open submenu trigger keeps it open or toggles it closed; the default preserves existing behavior. (1.3.0) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#130)
- Added CSS custom properties for item indicators' translate values, allowing developers to use them in styling. (1.2.18) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#1218)

### Performance

- Bundlers can drop unused components more effectively, improving dead-code elimination. (1.2.19) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#1219)

### Tooling

- The package is republished through CI so it includes a provenance attestation, which developers can use when evaluating package provenance. (1.2.20) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#1220)

### Fixes and other changes

- Fixed a type regression so callback props declared as methods accept handlers whose parameter is narrower than the prop's. (1.4.1) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#141)
- The content element now has a data-state attribute when using NavigationMenu.Viewport. (1.4.0) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#140)
- Optional types now allow explicit undefined, making them compatible with TypeScript's exactOptionalPropertyTypes flag. (1.4.0) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#140)
- Fixed a bug where a submenu's defaultValue was reset when an external element was focused before the menu opened. (1.3.0) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#130)
- Reverted breaking changes that caused compatibility issues with React Server Components. (1.2.22) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#1222)
- Fixed an infinite re-render loop in React 19 caused by unstable composed ref callback references. (1.2.17) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#1217)
- Fixed errors that surfaced when consuming multiple packages together. (1.2.16) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#1216)
- Triggers no longer reference a non-existent element via aria-controls when their content is removed from the DOM. (1.2.15) — [release notes](https://github.com/radix-ui/primitives/blob/925c88b773bb32aecf1b52a296a1a21ba7a720b9/packages/react/navigation-menu/CHANGELOG.md#1215)