Back Button Options
Controls the back button styling.
accessibilityLabel#
Overrides the text that's read by the screen reader when the user interacts with the back button.
| Type | Required | Platform |
|---|---|---|
| string | No | Android |
id#
Button id for reference press event.
| Type | Required | Platform |
|---|---|---|
| string | No | Android |
color#
Change the back button color. This will change the text color as well.
| Type | Required | Platform |
|---|---|---|
| color | No | Both |
icon#
Change the default back button icon.
| Type | Required | Platform |
|---|---|---|
| ImageResource | No | Both |
sfSymbol#
SF Symbol to show as the back button
| Type | Required | Platform |
|---|---|---|
| string | No | iOS 13+ |
showTitle#
Show or hide the text displayed next to the back button.
| Type | Required | Platform |
|---|---|---|
| number | No | iOS |
displayMode#
Set display mode of the back button. Currently works for iOS 14+ only. See: UINavigationItem.BackButtonDisplayMode
| Type | Required | Platform |
|---|---|---|
| enum('default', 'generic', 'minimal') | No | iOS |
title#
Change the text displayed next to the title. Usually the back button shows the title of the previous screen.
| Type | Required | Platform |
|---|---|---|
| string | No | iOS |
visible#
Hide or show the back button.
| Type | Required | Platform |
|---|---|---|
| boolean | No | Both |
testID#
Used to interact with the back button in e2e tests.
| Type | Required | Platform |
|---|---|---|
| string | No | Both |
enableMenu#
Enables iOS 14 back button menu display.
| Type | Required | Platform | Default |
|---|---|---|---|
| boolean | No | iOS | true |
popStackOnPress#
Controls whether the default back button should pop screen or not.
| Type | Required | Default |
|---|---|---|
| boolean | No | true |
hideSharedBackground#
Hide the shared Liquid-Glass / Platter background that UIKit draws behind the back button starting with iOS 26. RNN defaults this to true when the back button uses an iconBackground so the system Platter does not double-decorate it. Set to false to keep the system-drawn background.
| Type | Required | Platform | Default |
|---|---|---|---|
| boolean | No | iOS 26+ | true |