Type your domain and this validator downloads your apple-app-site-association (AASA) file the same way Apple does, checks every rule that can break Universal Links and compares it with the copy cached on Apple’s CDN. You can also paste the JSON directly and test which paths would open your app.
Loading…
What the validator checks
- That the file is served over HTTPS at
/.well-known/apple-app-site-association(or at the root) without redirects. - The
Content-Type(ideallyapplication/json) and the size: Apple ignores files over 128 KB uncompressed. - That the JSON is valid and has no BOM, and that every
appIDsentry isTEAMID.bundle.id. - The modern
componentsformat and the legacypathsformat, including exclusions, query items and fragments. - The
webcredentialsandappclipssections, if you use them. - What Apple’s CDN (
app-site-association.cdn-apple.com) is currently serving for your domain, which is what devices actually download.
How to use it
- Type your domain (for example
example.com) and press the button, or switch to the paste tab and paste your JSON. - Fix anything marked in red first: those errors stop Universal Links from working at all.
- Use the URL tester to check that the paths you care about open the app and the excluded ones stay in Safari.
- Copy the entitlements snippet into Xcode (Signing & Capabilities → Associated Domains).
Frequently asked questions
Why do my Universal Links still open Safari after fixing the file?
Devices download the file from Apple’s CDN, not directly from your server, and the CDN can take a while to refresh. Compare both copies in the results. During development you can add ?mode=developer to the associated domain to bypass the CDN on devices with developer mode enabled.
Can the file be served through a redirect?
No. Apple does not follow redirects for the AASA file, so example.com and www.example.com each need to serve it directly if you use both.
Do I need the «apps»: [] key?
Only in the legacy format. The modern format with appIDs and components does not need it, and the validator tells you which format you are using.
Is my domain stored?
The check runs from necsal.es to fetch your public file; results are cached for two minutes and nothing else is stored.
¿Prefieres español? Esta herramienta en español.