Help for owners
Links to my app open the browser instead of the app
Short answer
A link opens your app only if the app declares that link and, for ordinary web addresses on Android 12 and later, the app is verified for that domain. Otherwise Android sends it to the browser. Check whether the link is a custom scheme or a web link, and whether the domain is verified.
Does this sound like your situation?
- I tap a link in an email and a web page opens, not my app.
- On some phones a dialog asks which app to use.
- The app opens but on the home screen, not the right page.
- It worked on my test phone and not for customers.
- Links from some apps work and from others do not.
Why does this happen?
Android does not promise your app gets the link
Android routes a link by opening the user's default app for it, then the only app that can handle it, then showing a choice dialog. Android's documentation says that even if your declaration matches, the link may still not go to your app.
Confirmed by developer.android.com
Ordinary web links go to the browser on newer Android
From Android 12, a generic web link resolves to an activity in your app only if your app is approved for that specific domain. If not, it goes to the default browser.
Confirmed by developer.android.com
The three kinds of link behave differently
Android describes custom deep links (a made-up scheme), web links (http and https) and App Links, which are verified web links that skip the choice dialog. A custom scheme can still show the dialog if another app registers the same one.
Confirmed by developer.android.com
The declaration in the app is incomplete
The app's manifest needs the view action, the browsable category and the default category. Without browsable, a click in a browser cannot resolve to the app.
Confirmed by developer.android.com
The domain verification failed
App Links rely on the website proving it is associated with the app. When that fails, the link falls back to the browser. See the separate page on verification.
Confirmed by developer.android.com
What can I do about it today?
- Collect three example linksThe exact address, where it was tapped (email, SMS, social app) and the phone model and Android version.
- Check whether the app is installed from the storeA debug build or a different app version can be declared for different links.
- Look at the phone's 'Open by default' settingIn the app info screen on Android, see whether the app is allowed to open supported links. Do not clear data or uninstall.
- Try the link from two placesNotes app, and a messaging app. A link that works in one source and not another suggests the source app opens it in its own browser.
- Stop printing the link on materials until it worksUse a plain page with a store button as a safe fallback.
When should I bring someone in?
- The link is on printed material or in a live campaign.
- You need the link to carry the user to a specific screen, such as a product.
- It works on some Android versions and not others.
How do I handle it?
- Classify the linkI find out whether you use a custom scheme or web links, and what the app declares for them.
- Check the verification state on a deviceAndroid documents commands to read whether each domain is verified, and I use them on real phones of different versions.
- Fix declaration, then verification, then routingIn that order, because each depends on the previous one. Then I make sure the app reads the link and opens the right screen.
- Test from the real sourcesI open test links from email, SMS and social apps, with the app installed and not installed.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Why does it work for me and not for customers?
Your phone may have a debug build, a default you set earlier, or a different Android version. Test on a clean phone with the store version.
Is this the same on iPhone?
I have not verified Apple's rules for this page, so I only describe Android here.
Can I make it always open the app?
Not always. Android's documentation says the user has a key role in which app handles a link. Verified App Links are the the most dependable option.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.