> 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/external-url-handling.md).

# External URL Handling

Decide which links open inside your app and which hand over to a browser.

Your app is a web view, so every link your customers tap has to go somewhere. This decides where.

Open **General Settings** from the gear above your screen list, then the **External URL handling** tab.

## Set a default for each screen

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-92374f57b06bf548548e7e6b4423658a7d06c11b%2Fscreen-cust-url-handling.png?alt=media" alt="The External URL handling tab listing every screen with its own Application or Mobile Browser setting"><figcaption></figcaption></figure>

Every screen gets its own default. The three choices:

<table><thead><tr><th width="190">Option</th><th>What happens</th></tr></thead><tbody><tr><td><strong>Application</strong></td><td>Opens in the current screen. Customers stay in your app and a back button appears in the navigation bar.</td></tr><tr><td><strong>App Browser</strong></td><td>Opens a browser on top of your app. The screen underneath keeps its place, and closing returns the customer exactly where they were.</td></tr><tr><td><strong>Mobile Browser</strong></td><td>Leaves your app and opens the phone's browser.</td></tr></tbody></table>

{% hint style="info" %}
**Which to choose.** Keep your own pages in **Application** so customers never feel they have left. Use **App Browser** for links you want people to come back from — a help article, a terms page. Use **Mobile Browser** for anything that genuinely belongs outside, such as a social profile or a third-party checkout.
{% endhint %}

## Override with custom rules

A default covers most links, but some need different treatment. **Add custom rule** creates an exception.

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-831ad1d3b09665b81b18ebea660a46a9a244196d%2Fscreen-cust-custom-rules.png?alt=media" alt="A custom rule with URL expression, match type, where to open, and the screens it applies to"><figcaption></figcaption></figure>

<table><thead><tr><th width="170">Field</th><th>What it does</th></tr></thead><tbody><tr><td><strong>URL Expression</strong></td><td>The text to match against the link, such as <code>instagram.com</code>.</td></tr><tr><td><strong>Match as</strong></td><td>How to compare it — for example <strong>Substring</strong>, which matches any URL containing that text.</td></tr><tr><td><strong>Open in</strong></td><td>Where matching links should open.</td></tr><tr><td><strong>Screens</strong></td><td>Which screens the rule applies to.</td></tr></tbody></table>

{% hint style="success" %}
**The Screens picker is how you set something per screen.** Pick one screen and the rule applies only there; pick several and it applies to each. There is no longer a separate per-screen settings page — everything is set here and scoped with this field.
{% endhint %}

A typical rule: open anything containing `instagram.com` in the **Mobile Browser**, on every screen — so a social link hands over to the Instagram app rather than loading a login wall inside yours.

Click **Save as draft** when you are done.

## Common Questions

<details>

<summary>A link opens a blank screen in my app.</summary>

Usually a site that refuses to load inside a web view — many payment and social pages do. Add a custom rule sending it to the **Mobile Browser**.

</details>

<details>

<summary>Customers tap a link and never come back.</summary>

It is set to **Mobile Browser**, which leaves your app entirely. Use **App Browser** instead; closing it returns them to where they were.

</details>

<details>

<summary>Do rules apply in order?</summary>

A custom rule takes precedence over the screen's default. Keep expressions specific enough not to overlap.

</details>
