The Apple App Site Association (AASA) file, commonly named apple-app-site-association
, is used to enable Universal Links on iOS devices.
It allows developers to associate a website with an iOS app, so that links to the website open directly in the app rather than in a browser. This file is essential for creating seamless experiences between a company’s website and its mobile app by allowing specific URL patterns to automatically launch the corresponding app.
Technical Notes
The apple-app-site-association
file is placed in the .well-known/
directory of a website, typically accessible via https://example.com/.well-known/apple-app-site-association
.
It defines which URLs should be handled by the app and is signed using Apple’s guidelines to ensure security. This file is a crucial part of deep linking for iOS apps, offering users a smoother and more integrated navigation experience between mobile web and native apps.
Example
{
"applinks": {
"apps": [],
"details": [
{
"appID": "ABCDE12345.com.example.app",
"paths": [ "/blog/*" ]
}
]
}
}
Webflow
Webflow does not directly support this file, but redirects may work.
Webflow has recommended this approach;
https://share.getcloudapp.com/v1um4rqz
- Create your file, with the content you want
- Upload it to your site assets
- Get the URL of the uploaded asset
- Create a redirect from the path you need to your URL
- Publish your site
To ensure no problems with the redirects you can use a reverse proxy solution like Sygnal's Hyperflow to deliver your files reliably.