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

OptionSetup effortNotes
URI scheme, e.g. myapp://product/42LowWorks with GoLink as-is. iOS may ask "Open in MyApp?" the first time.
Universal Link (iOS) / App Link (Android) on your domainMediumNeeds 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:

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 / appApp installedApp not installed
iPhone, SafariApp opens (may ask first for schemes)App Store
iPhone, link in Messages / NotesApp opensApp Store
Android, ChromeApp opensGoogle Play
Instagram / Facebook / TikTokGoLink page with explicit buttons; behavior varies by app version
DesktopWeb fallback
Known limitations. No deferred deep linking (opening a screen after a fresh install). Universal Links reached through a redirect usually open the app, but iOS doesn't guarantee it in every context, so test the exact places your link will be shared. Links opened inside in-app browsers depend on that app's rules.
Try GoLink free. Create a smart link in seconds, no signup needed.