/ 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.

developer.apple.com → Membership.

Xcode → Signing & Capabilities.

One per line. Empty = every path.

Optional. Written first, so they win.

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:

apple-app-site-association
{
  "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.

Start free