---
title: "Android Intent URL and browser_fallback_url, Explained | Appy"
description: "How S.browser_fallback_url works in an intent:// link, three working examples, what Chrome and in-app browsers do, and how to debug a fallback that never fires."
source: "https://appy.to/blog/android-intent-url-browser-fallback-url"
---

[← Back to Blog](https://appy.to/blog)

Guide

# Android Intent URLs: How browser\_fallback\_url Works and How to Debug It

An intent:// link asks Chrome on Android to open your app, and S.browser\_fallback\_url tells it where to go when it can’t. Three working examples, what happens in each browser, and the checks to run when the fallback doesn’t fire.

Appy•November 13, 2026•8 min read

One link that opens the app on Android and iPhone

-   Builds the intent:// and myapp:// links for you
-   App Store, Google Play or your website when the app is missing
-   Free plan, no credit card

[Create my free deep link](https://appy.to/account/register)

Summarize with[ChatGPT](https://chatgpt.com/?q=Summarize%20this%20page%20and%20list%20its%20key%20points%3A%20https%3A%2F%2Fappy.to%2Fblog%2Fandroid-intent-url-browser-fallback-url) [Claude](https://claude.ai/new?q=Summarize%20this%20page%20and%20list%20its%20key%20points%3A%20https%3A%2F%2Fappy.to%2Fblog%2Fandroid-intent-url-browser-fallback-url) [Perplexity](https://www.perplexity.ai/search?q=Summarize%20this%20page%20and%20list%20its%20key%20points%3A%20https%3A%2F%2Fappy.to%2Fblog%2Fandroid-intent-url-browser-fallback-url)

Short answer

## How does browser\_fallback\_url work in an Android intent URL?

S.browser\_fallback\_url is an extra inside an intent:// link: the web address Chrome on Android loads when no installed app can open the intent or the app doesn’t launch. It has to be a full, percent-encoded https address, and Chrome only acts on the link after a real tap, never from a timer, the address bar or a redirect from a typed address.

Key takeaways

-   Encode the fallback address; the intent separates its fields with semicolons, so an unencoded ; or # breaks it.
-   If the package or scheme doesn’t match the installed app, Chrome loads the fallback even though the app is there.
-   intent:// only works on Android. iPhones need Universal Links, and in-app browsers often ignore intent links.

## The short answer

An intent URL is a link that Chrome on Android hands to an app instead of loading it as a web page. S.browser\_fallback\_url is an extra inside that link: the web address Chrome loads when no installed app can open it, or when the app doesn’t launch.

Chrome only acts on an intent URL after a real tap. A link opened by a timer, typed into the address bar or reached through a redirect from a typed address does nothing, and that accounts for most “fallback not working” reports.

## Anatomy of an intent URL

The same link the deep link generator builds for a shop app with the scheme myshop.

intent://product/42#Intent;scheme=myshop;package=com.example.myshop;S.browser\_fallback\_url=https%3A%2F%2F…;end

1.  intent://product/42

Host and path

What the app receives. With the scheme below it becomes myshop://product/42.

2.  #Intent;

Start of the intent

Everything from here to end is instructions for Android, not part of the address.

3.  scheme=myshop;

Scheme

Must match the scheme in one of the app’s intent filters.

4.  package=com.example.myshop;

Package

The app’s application ID. Only this app may open the link.

5.  S.browser\_fallback\_url=https%3A%2F%2F…;

Fallback

A full https address, percent-encoded. Chrome removes it before the app sees the intent.

6.  end

End

Closes the intent. Every field before it ends with a semicolon.


Fields are separated by semicolons, which is why the fallback address has to be encoded: an unencoded ; or # inside it cuts it short.

## Three working examples

All three open myshop://product/42 when the app is installed. They differ in where Chrome goes when it isn’t.

Fallback to a web page

```
<a href="intent://product/42#Intent;scheme=myshop;package=com.example.myshop;S.browser_fallback_url=https%3A%2F%2Fexample.com%2Fproduct%2F42;end">
Open in the app
</a>
```

Fallback to Google Play

```
<a href="intent://product/42#Intent;scheme=myshop;package=com.example.myshop;S.browser_fallback_url=https%3A%2F%2Fplay.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.example.myshop;end">
Open in the app
</a>
```

Google Play with a campaign referrer

```
<a href="intent://product/42#Intent;scheme=myshop;package=com.example.myshop;S.browser_fallback_url=https%3A%2F%2Fplay.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.example.myshop%26referrer%3Dutm_source%253Dnewsletter%2526utm_campaign%253Dspring;end">
Open in the app
</a>
```

In the third example the Play referrer is encoded twice: once inside the Play URL, and again as part of the fallback.

## What happens where

Where the link is opened

App installed

App not installed

A tap in Chrome

App installed: The app opens on product/42

App not installed: Chrome loads the fallback address

A tap in an in-app browser (Instagram, TikTok, Facebook)

App installed: Up to that app. Many ignore intent:// links

App not installed: Up to that app. Test it

JavaScript redirect without a tap

App installed: Chrome doesn’t launch the app

App not installed: Nothing happens

Typed into the address bar, or a redirect from a typed address

App installed: Chrome doesn’t launch the app

App not installed: Nothing happens

iPhone, any browser

App installed: iOS doesn’t know intent://

App not installed: iOS doesn’t know intent://

The Chrome rows follow Chrome’s own documentation. In-app browsers change with their updates, so check them on a real phone.

## The fallback doesn’t fire: check these in order

Most failures come from the first three.

01

### Make sure there is a tap

Use a real <a href> or a click handler. A link opened from a timer, on page load or after an async call loses the user gesture, and Chrome drops it without loading the fallback either.

02

### Test from a page, not the address bar

Typing intent:// into the address bar, or redirecting to it from an address you typed, is ignored. Put the link on a test page and tap it.

03

### Decode the fallback

S.browser\_fallback\_url has to be a complete http or https address, percent-encoded. Paste it into a decoder and check you get the address back in one piece, with its own query string.

04

### Match the package and the scheme

If package doesn’t match the installed app’s application ID, or the scheme isn’t in one of its intent filters, Chrome treats the intent as unresolved and loads the fallback even though the app is on the phone.

05

### Make the activity BROWSABLE

Only activities with android.intent.category.BROWSABLE can be started from a web page. Without it the app never opens from Chrome.

06

### Open the URI without Chrome

Run the adb command below. If the app doesn’t open the screen here, the problem is in the app’s intent filter, not in the link.

07

### Try the browsers your users have

Chrome, Samsung Internet and the in-app browsers of the apps your links are shared in. The in-app browser checker shows which one a page is open in.

## The app side

An intent filter that accepts myshop://product/… from the web, and the command that opens the URI on a connected phone.

AndroidManifest.xml

```
<activity
android:name=".ProductActivity"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="myshop" android:host="product" />
</intent-filter>
</activity>
```

Terminal

```
adb shell am start -W -a android.intent.action.VIEW \
-d "myshop://product/42" com.example.myshop
```

android:exported="true" is required for activities with intent filters on Android 12 and later.

## Intent URLs, App Links and iPhone

An intent URL only works on Android, and only from web pages you control. If you share links in ads, emails and social posts, a verified Android App Link is the sturdier choice: an https address that opens the app when it is installed and loads your website when it isn’t, with no browser involved in the decision.

iPhones need their own route: Universal Links, set up with an apple-app-site-association file. A link that has to work on both platforms and on a computer usually ends up as one https address that picks the right path for each device.

## Where Appy fits

The deep link generator builds the intent URL and the myapp:// link from your scheme, screen path and store links, and turns them into one Appy link. That link sends iPhones to the App Store, Android phones to Google Play and computers to your website on the free plan, and opens the app on the right screen on Pro, without an SDK.

## Tools and definitions

-   [Deep link generatorBuilds the intent URL, the scheme link and one https link for every device.](https://appy.to/tools/deep-link-generator)
-   [In-app browser checkerShows which in-app browser a page is open in and what it does to a link.](https://appy.to/tools/in-app-browser-checker)
-   [What is an intent URL?The short definition, with the parts of the link.](https://appy.to/glossary/intent-url)
-   [What are Android App Links?Verified https links that open your app without a chooser.](https://appy.to/glossary/android-app-links)

## Sources, read on November 13, 2026

-   [Chrome for Developers · Android Intents with Chromedeveloper.chrome.com/docs/android/intents](https://developer.chrome.com/docs/android/intents)
-   [Android Developers · Create deep links to app contentdeveloper.android.com/training/app-links/deep-linking](https://developer.android.com/training/app-links/deep-linking)
-   [Android Developers · Verify Android App Linksdeveloper.android.com/training/app-links/verify-android-applinks](https://developer.android.com/training/app-links/verify-android-applinks)
-   [Android Developers · Android Debug Bridge (adb)developer.android.com/tools/adb](https://developer.android.com/tools/adb)

## Frequently asked questions

### Why isn’t browser\_fallback\_url working?

Usually because Chrome never got a tap: the link was opened by JavaScript, typed into the address bar or reached through a redirect. The other common causes are an unencoded fallback address and a package or scheme that doesn’t match the app.

### Does browser\_fallback\_url have to be URL-encoded?

Encode it. The intent uses semicolons to separate its fields, so an unencoded ; or # in the address breaks the link. Chrome’s own example uses a percent-encoded address.

### Can the fallback be a Google Play link?

Yes. Use the full https://play.google.com/store/apps/details?id=… address, encoded. To keep a campaign referrer, encode the referrer inside the Play URL first, then encode the whole Play URL again for the fallback.

### Why does Chrome load the fallback even though the app is installed?

The intent didn’t resolve: the package doesn’t match the app’s application ID, the scheme or host isn’t in an intent filter, or the activity isn’t BROWSABLE. Test the URI with adb to tell the two apart.

### Do intent URLs work on iPhone?

No. intent:// is an Android and Chrome mechanism. iPhones use Universal Links, or a custom scheme that only works when the app is installed.

## Continue exploring

Comparison

Sep 24, 2026

6 min read

### Dub.co Alternative for Mobile Apps: App Links Without the $30 Paywall

Dub is a web link shortener that has turned into an affiliate platform. Mobile comes second: deep links need the $30 plan, attribution the $90 plan, Android attribution still isn’t out and Huawei isn’t supported at all. Here’s how Appy compares for app teams.

dub alternative

dub.co

deep links

android

[Read article](https://appy.to/blog/dub-alternative-app-links)

Guide

Nov 13, 2026

7 min read

### How to Test the Google Play Install Referrer on a Real Device

A build from Android Studio never has an install referrer. How to get a real one with an encoded Play URL, an internal testing track and a Kotlin read on first launch.

android

install referrer

google play

attribution

[Read article](https://appy.to/blog/test-google-play-install-referrer)

Guide

Oct 23, 2026

8 min read

### Deep Links in Email: Why Click Tracking Breaks Them, and How to Keep Both

Your campaign email links to a screen in your app and the tap opens your website. Click tracking is the reason. What each ESP documents, the three fixes and their cost, and a test plan for Gmail, Apple Mail and Outlook.

email

deep links

universal links

click tracking

[Read article](https://appy.to/blog/deep-links-in-email)

Looking for something else? Browse all topics on [the blog](https://appy.to/blog).

## One link instead of three

Appy builds the intent URL, the scheme link and an https link that sends every phone to the right place. Free plan, no credit card.

[Create my deep link](https://appy.to/tools/deep-link-generator)
