/ 01TOOLFREE TOOLS · FOR DEVELOPERS
AASA generator
Enter your Team ID, bundle ID and the paths your app opens, and get an apple-app-site-association file for iOS Universal Links, with exclusions in the right order. Runs entirely in your browser.
apple-app-site-association
{}
Upload it, with no file extension, to https://your-domain/.well-known/apple-app-site-association, then test it with the AASA validator.
What goes in the file
The applinks section lists which apps may open which URLs on your domain. Each entry in details names apps by app ID (Team ID, a dot, then the bundle ID) and a list of components, each matching a path, and optionally a query or fragment. iOS checks the components in order and uses the first that matches, so an excluded path has to come before a wildcard that would otherwise catch it:
{
"applinks": {
"details": [
{
"appIDs": ["ABCDE12345.com.example.shop"],
"components": [
{ "/": "/admin/*", "exclude": true },
{ "/": "/products/*" }
]
}
]
}
}Then turn it on in the app
The file does nothing until the app asks for your domain. In Xcode, add the Associated Domains capability with applinks:your-domain (and applinks:www.your-domain if links use it). Install the app on a phone; iOS fetches the file through Apple's CDN at install time, so after changing the file, reinstall to test. Universal Links open the app from a tap in another app, not from the address bar.
The file must be served with a 200, no redirect, as application/json, and stay under 128 KB. If your links run on a Strait link domain, Strait builds and serves this file from your app settings; iPhone links on Strait are live, tested on a real iPhone. See App Links & Universal Links.
Questions
Where do I find my Team ID?
Sign in at developer.apple.com and open Membership details: the Team ID is a 10-character code of letters and digits. Xcode also shows it under Signing & Capabilities when you pick your team.
What do the path patterns mean?
A pattern matches the URL path. * matches any run of characters and ? matches one character, so /products/* matches every product page. Leave the list empty to let the app open every path. Excluded patterns are written first because iOS stops at the first rule that matches.
Do I still need the "paths" format?
Just if you support iOS 12 or earlier. iOS 13 and later read "components". Ticking the option writes both, which is safe.
Does the file need to be signed?
No. Since iOS 9 the file is plain JSON. Serve it unsigned at /.well-known/apple-app-site-association with Content-Type application/json and no redirect.
Let the link domain serve it
Strait serves apple-app-site-association and assetlinks.json for your link domain, so a new path or a new key is one settings change.
More free tools
assetlinks.json generator
Package name and SHA-256 fingerprints in, a valid assetlinks.json out. Fixes fingerprint format as you type. Runs in your browser.
UTM builder for app links
Tag a link for WhatsApp, Instagram, SMS, email or a poster, and build a Google Play referrer URL for the same campaign.
App QR code generator
A QR code for a link that opens your app, as SVG or PNG, with a quiet zone and error correction set for print.