# What changed in @react-navigation/bottom-tabs

> 50 changes in @react-navigation/bottom-tabs 7 from its official release notes, upgrade guides and advisories: 2 breaking, 1 deprecations, 20 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/@react-navigation/bottom-tabs/

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

## @react-navigation/bottom-tabs 7

### Breaking changes

- The resource type is no longer supported for icons. (7.14.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.14.0)
- Native bottom tabs no longer show the native header by default. (7.8.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.8.0)

### Deprecations

- The object overload of navigate is deprecated. (7.18.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.18.0)

### New APIs and options

- Adds an option to set active-indicator size per tab. (7.21.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.21.0)
- Adds an option to set icon size per tab. (7.21.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.21.0)
- Adds support for specifying a rendering mode for SF Symbol icons. (7.21.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.21.0)
- Adds tabBarLabelPositionAdjustment for native tabs on iOS. (7.21.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.21.0)
- Adds a tabBarRole option for prominent and search tabs on iOS 27. (7.21.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.21.0)
- Adds support for tinted image icons on Android. (7.21.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.21.0)
- Adds tabBarRepeatedPressBehavior to tabs. (7.20.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.20.0)
- Custom navigators can use a render callback. (7.19.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.19.0)
- Adds createXScreen helpers to navigators. (7.17.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.17.0)
- Adds an option to prevent tab bar selection. (7.16.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.16.0)
- Native tab bars can now be hidden. (7.14.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.14.0)
- Supports setting the badge background color on iOS. (7.13.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.13.0)
- Supports setting the tab label color on iOS. (7.13.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.13.0)
- Native tabs now support xcasset for icons. (7.12.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.12.0)
- Adds support for disabling overrideScrollViewContentInsetAdjustmentBehavior. (7.11.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.11.0)
- Adds support for a bottom accessory to native tabs. (7.9.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.9.0)
- Exposes the icon type for native bottom tabs. (7.9.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.9.0)
- Adds new menu options to native bottom tabs. (7.9.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.9.0)
- Overrides the user interface style for native navigation to match the theme. (7.9.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.9.0)
- Adds an unstable native bottom tabs integration. (7.7.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.7.0)

### Behavior and default changes

- Native tabs now default lazy to true to avoid flicker. (7.16.2) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.16.2)
- Defaults multiselectable to undefined. (7.16.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.16.0)
- Native tabs now handle popToRoot natively. (7.10.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.10.0)
- Badge is moved to elements and exposed in the public API. (7.5.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.5.0)
- Corners use a continuous rounded style. (7.5.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.5.0)

### Fixes and other changes

- Custom active indicator color is no longer ignored in native tabs. (7.21.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.21.0)
- Lazy content rendering is deferred with useDeferredValue. (7.21.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.21.0)
- Fixes the scroll edge effect flashing when switching tabs. (7.21.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.21.0)
- Clears bottom tab animation state after a transition. (7.20.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.20.0)
- Frame size is measured in a layout effect. (7.19.2) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.19.2)
- Pop to top now uses the latest state to determine whether to act. (7.18.17) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.18.17)
- Sets the native tab screen background. (7.18.8) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.18.8)
- Screen detach state is no longer derived from an animated value. (7.18.8) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.18.8)
- Nested stacks now pop to the top on blur even when the animation is interrupted. (7.18.5) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.18.5)
- Fixes a flash while switching native bottom tabs when lazy is enabled. (7.17.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.17.0)
- Pointer events are disabled on inactive tab screens. (7.15.11) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.15.11)
- Native bottom tabs now include the background color and blur effect in scrollEdgeAppearance. (7.15.3) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.15.3)
- Native tabs now include tab item appearance in scrollEdgeAppearance. (7.14.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.14.0)
- Disables header height workarounds when the new react-native-screens implementation is used. (7.9.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.9.0)
- Fixes a type error with the id prop. (7.8.7) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.8.7)
- Fixes the native tab bar color in dark theme. (7.8.4) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.8.4)
- Tab switches are no longer wrapped in a transition. (7.8.3) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.8.3)
- Fixes native tabs not using the color from the tab bar badge style. (7.8.2) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.8.2)
- Fixes showing the search bar in the native tab bar. (7.8.1) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.8.1)
- Prevent default is disabled for native tabs, changing how their events handle default behavior. (7.7.2) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.7.2)
- Adds missing bottom tab options. (7.7.1) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.7.1)
- Unhandled state is restored after route names change. (7.6.0) — [release notes](https://github.com/react-navigation/react-navigation/releases/tag/%40react-navigation/bottom-tabs%407.6.0)