Home › App links setup
Developer docs: smart app links
GoLink decides where a visitor goes. Your app decides what to show when it's opened with a URL. This page covers both.
1. Choose how your app is opened
| Option | Setup effort | Notes |
|---|---|---|
URI scheme, e.g. myapp://product/42 | Low | Works with GoLink as-is. iOS may ask "Open in MyApp?" the first time. |
| Universal Link (iOS) / App Link (Android) on your domain | Medium | Needs verification files on your domain. GoLink redirects to it on iOS; on Android it's opened via an intent with your package. |
2. Create the GoLink link
In Create link, add the Open app rule:
- iOS app link:
myapp://product/42orhttps://go.example.com/product/42 - App Store URL:
https://apps.apple.com/app/id123456789 - Android package:
com.example.myapp(opens the app, or its Play Store page) - Android app link (optional):
myapp://product/42to open a specific screen - Web fallback: where desktop visitors go
On Android, GoLink turns this into a Chrome intent such as:
intent://product/42#Intent;scheme=myapp;package=com.example.myapp;S.browser_fallback_url=https%3A%2F%2Fplay.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.example.myapp;end
3. Register the URL in your app
iOS: URI scheme (Info.plist)
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleURLSchemes</key>
<array><string>myapp</string></array>
</dict>
</array>
iOS: Universal Links
Add the Associated Domains capability with applinks:go.example.com, then serve this file at
https://go.example.com/.well-known/apple-app-site-association (HTTPS, no redirects, application/json):
{
"applinks": {
"details": [
{
"appIDs": ["ABCDE12345.com.example.myapp"],
"components": [{ "/": "/product/*" }]
}
]
}
}
Android: manifest
<activity android:name=".MainActivity" android:exported="true">
<!-- URI scheme: myapp://product/42 -->
<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="myapp" android:host="product" />
</intent-filter>
<!-- App Link: https://go.example.com/product/42 -->
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" android:host="go.example.com" android:pathPrefix="/product" />
</intent-filter>
</activity>
For App Links, serve https://go.example.com/.well-known/assetlinks.json as application/json.
Use the SHA-256 of your Play app signing certificate (Play Console → App integrity), not only your upload key:
[{
"relation": ["delegate_permission/common.handle_all_urls"],
"target": {
"namespace": "android_app",
"package_name": "com.example.myapp",
"sha256_cert_fingerprints": ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
}
}]
Check both files with the free checker.
4. Handle the URL in your code
Flutter (app_links package)
import 'package:app_links/app_links.dart';
final appLinks = AppLinks();
void initDeepLinks() {
// Handles the link that launched the app and links received while running.
appLinks.uriLinkStream.listen((Uri uri) {
if (uri.pathSegments.isNotEmpty && uri.pathSegments.first == 'product') {
navigatorKey.currentState?.pushNamed('/product', arguments: uri.pathSegments.last);
}
});
}
Note: for myapp://product/42, "product" is the URI host and "42" the path. Check both
uri.host and uri.pathSegments if you support schemes and https links.
React Native
import { useEffect } from 'react';
import { Linking } from 'react-native';
function handleUrl(url) {
if (!url) return;
const match = url.match(/product\/(\w+)/);
if (match) navigation.navigate('Product', { id: match[1] });
}
export function useDeepLinks() {
useEffect(() => {
Linking.getInitialURL().then(handleUrl); // app opened by the link
const sub = Linking.addEventListener('url', ({ url }) => handleUrl(url)); // app already running
return () => sub.remove();
}, []);
}
Swift (SwiftUI)
@main
struct MyApp: App {
@State private var productId: String?
var body: some Scene {
WindowGroup {
ContentView(productId: $productId)
// Called for both URI schemes and Universal Links.
.onOpenURL { url in
if url.pathComponents.contains("product") || url.host == "product" {
productId = url.lastPathComponent
}
}
}
}
}
Kotlin (Android)
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
handleLink(intent)
}
override fun onNewIntent(intent: Intent) {
super.onNewIntent(intent)
handleLink(intent)
}
private fun handleLink(intent: Intent?) {
val uri = intent?.data ?: return
// myapp://product/42 -> host = "product", lastPathSegment = "42"
// https://go.example.com/product/42 -> pathSegments = [product, 42]
val id = uri.lastPathSegment ?: return
openProduct(id)
}
}
5. Test on real devices
| Device / app | App installed | App not installed |
|---|---|---|
| iPhone, Safari | App opens (may ask first for schemes) | App Store |
| iPhone, link in Messages / Notes | App opens | App Store |
| Android, Chrome | App opens | Google Play |
| Instagram / Facebook / TikTok | GoLink page with explicit buttons; behavior varies by app version | |
| Desktop | Web fallback | |