Apple App Site Association Generator
Free AASA file generator. Create the apple-app-site-association JSON with applinks details, path rules, and optional webcredentials.
Loading tool...
What is Apple App Site Association Generator?
This tool builds the apple-app-site-association (AASA) JSON file that connects your website to your iOS app through Universal Links. Enter your app IDs, define the URL paths your app handles, optionally enable Shared Web Credentials, and copy or download a ready-to-deploy file.
Key Benefits
- No hand-editing fragile JSON syntax
- Live validation of app ID and path formats
- Supports multiple apps sharing the same paths
- Optional webcredentials section included
- Instant copy and download, works offline
Common Use Cases
- •Set up Universal Links for a new iOS release
- •Share password autofill between website and app
- •Migrate link routing when adding a second app
- •Regenerate the AASA after adding marketing campaign URLs
How to Generate an AASA File
- Enter your app IDs: Add one or more app IDs in TEAMID.BUNDLE_ID format, e.g. ABCDE12345.com.example.app. You can add several apps to share the same link paths.
- Define path rules: List supported paths one per line, e.g. /articles/* or /invite/?code=*. Prefix a line with NOT to exclude it, e.g. NOT /private/*.
- Add optional sections: Toggle webcredentials if your app shares passwords with your website, then list your domains.
- Copy, download, deploy: Download the generated JSON, host it at https://yourdomain.com/.well-known/apple-app-site-association without a file extension, serve it as application/json over HTTPS, then reinstall the app to refresh.
Key Features
- Generates valid apple-app-site-association JSON with live preview
- Supports multiple app IDs (TEAMID.BUNDLE_ID) per details entry
- Path rules incl. NOT exclusions, one per line
- Optional webcredentials section for Shared Web Credentials
- Format validation with inline error messages
- Runs 100% in the browser - no data leaves your machine
Frequently Asked Questions
What is an apple-app-site-association (AASA) file?
It is a JSON file that iOS fetches from your website to authorize Universal Links and Shared Web Credentials. It maps which app IDs may open which URL paths on your domain.
Where do I host the generated file?
Serve it at https://yourdomain.com/.well-known/apple-app-site-association with no file extension and Content-Type application/json over a valid HTTPS certificate. Redirects to another domain are allowed only within limits set by Apple.
How long does iOS take to pick up changes?
iOS downloads the AASA when the app is installed and periodically afterwards. To force a refresh, delete and reinstall the app, or use the App Search API validation tool. CDN caching can delay updates, so keep TTLs short while testing.
What path patterns are supported?
Applinks support * wildcards anywhere, ? for a single character, and NOT prefixes to exclude routes. For example /news/* matches any path under /news/, while NOT /news/private/* excludes a subfolder.
Why are my Universal Links not opening the app?
Common causes: the AASA is not reachable over HTTPS without redirects, the app ID does not match the Team ID and bundle ID of the installed build, the Associated Domains entitlement is missing, or iOS has cached an older version of the file.