> 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/native-integrations/overview-1/pull-to-refresh.md).

# Pull to Refresh

Let users reload the current page by swiping down.

Pull to refresh lets customers reload the page by swiping down from the top of the screen. It is the gesture people already use in every other app on their phone, so most will try it without being told.

## Turn it on

Open **Native Features → Pull to Refresh** and switch on **Enable Pull To Refresh**.

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-ed56572b5c66cd1a0b24e9aa63fb5294da16d0a7%2Fnf-pull-to-refresh.png?alt=media" alt="The Pull to Refresh screen with the enable toggle and loader colour"><figcaption></figcaption></figure>

**Loader Color** sets the refresh indicator that appears as the customer pulls. Pick a theme colour or set your own.

Click **Save as draft**.

## Why turn it on

Phones hide the browser's reload button, so without this gesture a customer who sees a stale page has no way to ask for a fresh one short of closing the app.

It matters most where content changes while someone is looking at it — stock levels, order status, a delivery tracker, anything live.

{% hint style="info" %}
This pairs with [Cache Policy](https://help.twinr.dev/native-integrations/overview-1/cache-policy.md). A cautious cache setting reduces stale pages in the first place; pull to refresh gives customers a way out when one slips through.
{% endhint %}

{% hint style="warning" %}
On a page with its own pull-down behaviour — an image carousel, a map, a custom scroll area — the two gestures can compete, and the page may refresh when the customer meant to scroll. If a particular screen misbehaves, that is worth checking on a real device.
{% endhint %}

## Check it

Open your app in Twinr Preview, swipe down from the top of a page, and the indicator appears in your chosen colour. See [Preview App](https://help.twinr.dev/create-app/preview-app.md).
