Validate your existing AASA file or generate a new one from scratch. No sign-up, no data stored, runs entirely from your browser.
No sign-up
Free
Runs in your browser
Check an existing AASA file
https://
How it works
01
Install & cache
On app install, iOS downloads and caches the AASA file from your domain via Apple's CDN.
02
Link tap
A user taps a link pointing to your domain, in Messages, Mail, or any app.
03
App opens
If the URL path matches a pattern in your AASA, iOS opens your app directly to the right screen.
Questions
An Apple App Site Association (AASA) file is a JSON file hosted on your website that tells iOS which app should handle links to your domain. It enables Universal Links: clicking a link in Safari or another app opens your iOS app directly instead of a browser.
Apple looks for the AASA file at two locations on your server: https://yourdomain.com/.well-known/apple-app-site-association and https://yourdomain.com/apple-app-site-association. The file must be served over HTTPS with a 200 status code.
The AASA file should be served with Content-Type: application/json. For signed AASA files (older approach), use application/pkcs7-mime. Avoid serving it as text/plain as some CDNs do, this can cause iOS to reject the file.
Common causes include: (1) AASA file not reachable at the correct URL, (2) invalid JSON in the file, (3) wrong Content-Type header, (4) the "apps" array is not empty, (5) missing or incorrect Team ID in the appID, (6) app not registered in Xcode with the Associated Domains entitlement.
"paths" is the legacy format supported by all iOS versions. "components" is the modern format introduced in iOS 13 that offers more granular URL matching with support for query strings and fragments. Apple recommends using "components" for new apps.
This tool validates unsigned JSON AASA files. Signed AASA files (PKCS#7 format) are an older approach and Apple no longer requires them. Modern apps should use unsigned JSON AASA files.
Built by Witsberry
Building an iOS app with Universal Links?
We build mobile apps for businesses with real revenue on the line, from architecture to App Store launch, held to the WB-12 standard. Then we run them.