Documentation

Universal Links

Configure Universal Links so users tap a link to your website and land directly in your app.

Universal Links let users tap a link to your website and be taken directly to your app, rather than Safari. This requires an apple-app-site-association (AASA) file hosted at your domain.

Configuration

In the Dashboard, go to the Associated Domains section and configure Universal Links:

  1. Add App IDs — Enter your App ID in the format TEAMID.com.example.app. Your Team ID is a 10-character alphanumeric string found in your Apple Developer account.
  2. Add URL Patterns — Specify which URL paths should open in your app (e.g., /products/*). You can mark patterns as excluded to keep certain URLs in Safari (e.g., /admin/*).

After deploying, your AASA file is served at /.well-known/apple-app-site-association and /apple-app-site-association.

Custom domain required Universal Links only work on domains you own. You must configure a custom domain to use this feature.

Xcode setup

In your Xcode project:

  1. Select your app target and go to Signing & Capabilities.
  2. Click + Capability and add Associated Domains.
  3. Add applinks:your-domain.com.
// In your AppDelegate or SceneDelegate
func application(_ application: UIApplication,
                 continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
          let url = userActivity.webpageURL else {
        return false
    }
    // Handle the URL in your app
    return handleUniversalLink(url)
}

Apple reference: Supporting Universal Links in Your App