A deep link opens a specific screen inside an app – a product, a chat, an article – instead of just the home screen. Deep links make emails, ads, QR codes and push notifications far more effective, because users land exactly where they expect. Here is how they work on Android and iOS.
Page Contents
Three kinds of deep links
| Type | Example | Pros | Cons |
|---|---|---|---|
| Custom URL scheme | myshop://product/42 | Easy to set up | Does nothing if the app is not installed; any app can claim the same scheme |
| Android App Links | https://myshop.com/product/42 | Verified, opens the app directly, falls back to the website | Needs a file on your website |
| iOS Universal Links | https://myshop.com/product/42 | Same as App Links for iPhone | Needs a file on your website |
For anything users share or click from the web, use https links (App Links and Universal Links). Custom schemes are fine for internal use and testing.
Android App Links
- Add an intent filter with
android:autoVerify="true", the https scheme, your host and path to the activity inAndroidManifest.xml. - Publish
https://yourdomain.com/.well-known/assetlinks.jsonwith your package name and the SHA-256 fingerprint of your signing certificate. - If you use Play App Signing, take the fingerprint from Play Console (App signing key), not only your upload key.
- Test with
adb shell am start -a android.intent.action.VIEW -d "https://yourdomain.com/product/42".
iOS Universal Links
- Turn on the Associated Domains capability and add
applinks:yourdomain.com. - Publish
https://yourdomain.com/.well-known/apple-app-site-association(no file extension) with your Team ID, bundle ID and paths. - Serve it over https without redirects.
- Handle the incoming URL in your app and route to the right screen.
What happens if the app is not installed?
With https links, the user simply opens the web page – so make sure the URL works on your website too. To send new users to the store and then to the right screen after install (“deferred deep linking”), you need a third-party attribution service. Note that Firebase Dynamic Links was shut down in 2025, so apps that relied on it must migrate.
Where to use deep links
- Push notifications – see our push notification guide
- Emails and SMS campaigns (add tracking with our UTM Builder)
- QR codes on packaging and posters – make one with the QR Code Generator
- Social media posts and ads
- Password reset and login links
Common problems
- Link opens the browser instead of the app: verification failed – check the assetlinks.json fingerprint or AASA file and that it is served over https.
- Works in testing but not from Gmail or Instagram: some in-app browsers handle links differently; test real channels.
- App opens but shows the home screen: your app is not reading the incoming URL and routing it.
FAQ
What is a deep link?
A link that opens a specific screen inside an app.
What is the difference between App Links and Universal Links?
They are the same idea on different platforms: verified https links that open your app on Android (App Links) and iOS (Universal Links).
Do I need a website for deep links?
For App Links and Universal Links, yes – you must host verification files on your domain.
What replaced Firebase Dynamic Links?
Google recommends App Links and Universal Links, plus a third-party service if you need deferred deep linking.
Can a QR code open my app?
Yes. Encode an https App Link or Universal Link in the QR code.
Need help building or publishing your app? Talk to Techpass Master – we design, build and publish Android apps for clients worldwide.
