> For the complete documentation index, see [llms.txt](https://help.twinr.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.twinr.dev/screen-customization/navigation-bar.md).

# Navigation Bar

The native top bar on a screen — its title and its buttons.

The navigation bar is the strip across the top of a screen. It holds the screen's title and the buttons your customers tap to get around — back, cart, a menu, a share link.

It is **native**, drawn by the app rather than loaded from your website. That is what makes it feel like an app instead of a web page in a frame: it stays put while the page underneath scrolls, and it appears instantly when the screen opens, before your site has finished loading.

**Every screen has its own navigation bar.** Turning it on for your Home screen does nothing to Search or Account — you set each one up where you set up that screen.

## Turn it on

Open **Screens**, pick a screen, and choose the **Navigation bar** tab.

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-5971008feda299bc5df5860860649b566d990855%2Fnav-bar-tab.png?alt=media" alt="The Navigation bar tab with Enable navigation bar switched on, showing Title type, Title position and Title image"><figcaption></figcaption></figure>

**Enable navigation bar** is the master switch. Everything else on the tab stays hidden until you turn it on, so if the tab looks almost empty, that is why.

{% hint style="info" %}
Most websites already have their own header. If you leave the native bar off, your site's header shows instead — it will scroll away with the page and take a moment to appear. Turning the native bar on usually looks better, but then you may want to hide your site's header so customers don't see two. See [Hide Elements](https://help.twinr.dev/screen-customization/hide-elements.md).
{% endhint %}

## What you can set

| Setting                    | What it does                                                                                                                                             |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Title type**             | Whether the bar shows text or your logo. See [Navigation Bar Title](https://help.twinr.dev/screen-customization/navigation-bar/navigation-bar-title.md). |
| **Title position**         | `left` or `center`.                                                                                                                                      |
| **Title image**            | The image to show, when the title type is an image.                                                                                                      |
| **Navigation bar buttons** | The buttons on either side of the title.                                                                                                                 |

## Buttons

Below the title settings, the bar is split into **Left side buttons** and **Right side buttons**. Each side has its own **+ Add**.

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-0e56030de49cfce03a08de335abe4ef21105c07d%2Fnav-bar-buttons-list.png?alt=media" alt="The Navigation bar buttons section showing Back on the left side and no buttons on the right"><figcaption></figcaption></figure>

Buttons appear in the order you add them, reading outward from the edge. A side with nothing on it says *No buttons added yet*.

There are eight types to choose from, covered in [Navigation Bar Buttons](https://help.twinr.dev/navigation-bar-buttons/navigation-bar-buttons.md).

{% hint style="info" %}
**Back** is already there on the left, on every screen. You cannot remove it, and you cannot move another button above it — it stays closest to the edge. It appears only once there is somewhere to go back to, so on the first page of a screen your customers will not see it at all.
{% endhint %}

## Save

Changes are held as a draft until you click **Save as draft**, and they reach your customers when you publish a build.
