Skip to main content
To open your app from DeepLink links on iOS and attribute installs, you need Associated Domains and optional Universal Links configuration.

​
1. Associated Domains entitlement

  1. In Xcode, select your app target and open Signing & Capabilities.
  2. Click + Capability and add Associated Domains.
  3. Add your DeepLink domain in this form:
    • applinks:your-domain.com Replace your-domain.com with the host you use in the DeepLink dashboard (e.g. your app’s subdomain).
In the project, this is stored in ios/Runner/Runner.entitlements (or your custom entitlements file): 
<key>com.apple.developer.associated-domains</key>
<array>
  <string>applinks:your-domain.com</string>
</array>

​
2. Apple App Site Association (AASA)

DeepLink automatically hosts the required Apple App Site Association (AASA) file on your link domain (managed or custom) once you configure your app’s bundle ID and Apple Team ID in the dashboard. You don’t need to create or host this file yourself.

​
3. Initialize the SDK

In your Flutter app, call the DeepLink SDK init with your API key (and optional base URL) as shown in Quickstart. On iOS, since there is no install referrer like Android, the backend:
  • Looks at recent clicks for this user/device.
  • Computes a score based on IP (including partial matches), country, city, platform, OS version, and deviceId (when present).
  • Picks the best-matching click above a minimum score and attributes the install to that link (including its UTM and campaign data).

​
4. Test on device

Universal Links often do not work in the simulator. Test on a real device:
  1. Install the app from Xcode (or TestFlight).
  2. Open a DeepLink link in Safari (or Messages) — do not paste the link in the address bar; use a tap from another page or app.
  3. The app should open if the domain and AASA are correct.

​
Troubleshooting

  • Link opens in Safari instead of the app — Confirm the entitlement domain matches the link host exactly (no https://, no path). Ensure the AASA file is at /.well-known/apple-app-site-association and returns the correct Content-Type (e.g. application/json).
  • Install not attributed — The backend matches by IP and recent click; ensure the Track Install (or SDK) call runs on first launch and that the user actually clicked a DeepLink link before installing.

Handling links

Handle incoming deep link URLs in your app.