> For the complete documentation index, see [llms.txt](https://docs.buildnatively.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildnatively.com/natively-platform/features/ios-back-button.md).

# iOS Back Button

## What is iOS Back Button?

The iOS Back Button is an on-screen navigation control placed in the bottom-left corner of the screen. Tapping it returns the user to the previous page in their browsing history - replicating the behavior of Android's native back button, which iOS doesn't have. This is especially useful if your website relies on browser history or URL parameters for navigation.

{% hint style="warning" %}
This feature relies on your website's URL-based navigation history. If your website uses a navigation method that doesn't update the URL - such as single-page app routing without history updates - there may be no history for the button to go back to.
{% endhint %}

### Visual examples

<div><figure><img src="/files/QU54wQ2qBI60XWSlg5bk" alt=""><figcaption><p>Light Theme</p></figcaption></figure> <figure><img src="/files/XBNPQINq3VVPQxL6KQRI" alt=""><figcaption><p>Light Theme (with Bottom Bar enabled)</p></figcaption></figure> <figure><img src="/files/BeYX1EGjBV2H2xC5lu8O" alt=""><figcaption><p>Dark Theme</p></figcaption></figure> <figure><img src="/files/T6elj7wIhX19gynlzsd5" alt=""><figcaption><p>Dark Theme (with Bottom Bar enabled)</p></figcaption></figure></div>

## Prerequisites

{% hint style="success" %}
This feature requires the **Unlimited** or **Lifetime** plan. [See all plans](/getting-started/subscription-plans.md)
{% endhint %}

## Natively Dashboard Setup

1. Open your Natively app dashboard and navigate to **Features** > **iOS Back Button**.
2. Toggle the feature to **Enabled**.
3. Select a **Theme** - **Light** or **Dark**.
4. Click **Save**.
5. Rebuild your iOS app.

{% hint style="warning" %}
You must rebuild your app for these changes to take effect.
{% endhint %}

## Troubleshooting

<details>

<summary>The button doesn't appear after enabling it</summary>

Confirm the app has been rebuilt after toggling the feature on - like all Dashboard-configured features, this requires a rebuild to take effect.

</details>

<details>

<summary>Tapping the button exits the app instead of going back</summary>

This means there's no navigation history to go back to - most commonly because your website's navigation doesn't update the URL when moving between pages or sections (e.g., single-page app routing without history updates).

</details>

<details>

<summary>Not working in the Natively Preview app</summary>

Appearance and navigation-related settings like this one are not guaranteed to be reflected in the Preview app. Test on a real device using a full build.

</details>