Webflow sync, pageviews & more.
NEW

How can I host an AASA JSON file on my Webflow website for iOS Universal links?

TL;DR
  • Host the AASA JSON file externally and use a reverse proxy or Cloudflare Worker to serve it at https://yourdomain.com/.well-known/apple-app-site-association with application/json content type and no redirects.
  • Ensure the file is properly formatted, uncompressed, and accessible via HTTPS at the required path to enable iOS Universal Links for Webflow sites.

To enable iOS Universal Links, you need to host an Apple App Site Association (AASA) JSON file at a specific location: https://yourdomain.com/.well-known/apple-app-site-association. Webflow doesn’t support placing files directly at the root or in .well-known/ directories via its internal asset manager, so an alternate method is required.

1. Use an External Hosting Service for the AASA File

  • Host your AASA file externally using a service like Amazon S3, Firebase Hosting, or GitHub Pages.
  • Configure a reverse proxy or subdomain redirect to make the file accessible at the required path.
  • The file must be served from the domain (not a subdomain) over HTTPS, with the Content-Type set as application/json.

2. Use a Reverse Proxy with Cloudflare

If you’re using Cloudflare, follow these steps:

  • Set up Workers to serve a static AASA file at https://yourdomain.com/.well-known/apple-app-site-association.
  • In Cloudflare → Workers, create a new Worker script to respond with the JSON content when the request path matches /.well-known/apple-app-site-association.
  • Bind that worker to your route.

Example Worker route (must be configured in Cloudflare dashboard):
yourdomain.com/.well-known/apple-app-site-association

Set the worker to:

  • Return the AASA JSON.
  • Set appropriate headers: Content-Type: application/json, no redirects, and no file extension (must not be .json in URL).

This approach keeps the experience integrated with your main domain.

3. Verify iOS Requirements

  • Ensure the AASA file is properly formatted and uncompressed.
  • Serve via https:// at the exact path: /.well-known/apple-app-site-association.
  • The Content-Type must be application/json, not text/plain.

Apple will check for this file during universal link validation, so it’s critical that it loads correctly without redirects.

4. Test the File

Use Apple’s command-line test:

curl -I https://yourdomain.com/.well-known/apple-app-site-association

Check for:

  • 200 OK response.
  • Content-Type: application/json
  • No redirect (especially to a URL with .json extension or another domain).

Summary

Webflow doesn’t support hosting the AASA file directly, so you must use a proxy (e.g., Cloudflare Workers) to serve the AASA JSON file at /.well-known/apple-app-site-association. This maintains Apple’s strict requirements and makes iOS Universal Links functional with a Webflow-hosted site.

Webflow Resources
Webflow templates
Webflow inspiration
Rate this answer

Other Webflow Questions

Explore Logic tutorials
Is there a more efficient way to update images in Webflow without having to change the image file on each individual webpage? How do others navigate this issue, especially when dealing with multiple pages?
Is there a way to reverse the order of grid items for tablet and mobile devices in Webflow?
How can I integrate Woocommerce with my Webflow website that has been converted to Wordpress with Udesly, so that I can fully utilize the capabilities of Woocommerce for my shop?
How can I pass URL parameters to a redirect URL in Webflow? I need to be able to do this on any link on the page, and also include form dropdown selections.
Is there a way to effectively control Lottie animations in Webflow through other objects? I'm specifically interested in reversing the animation on a second button click, resetting it, or enabling looping.
How can I add a meta noindex to unfinished CMS pages in Webflow?
How can I create a full-page masonry grid portfolio with 4 columns and 3 rows using Webflow?
What are the best practices for embedding autoplaying and looping videos without controls or sound on a Webflow site? I want to achieve a gif-like video experience without sacrificing quality, similar to the videos found on specific websites. I've tried using the HTML embed widget in Webflow and following certain instructions, but I still encounter overlays and letterboxing. Are there any other services that freelance web developers can use for passive videos in their projects? Additionally, I'd like to understand the use cases and limitations of the "background video" and "video" widgets in Webflow. Are there any tutorials or posts that I may have missed during my research on this topic? Thank you.
Can I add rounded corners to Youtube videos and remove all icons except for the play button on the videos in Webflow?
Where can I find Javascript code to make a GIF start animating on hover in Webflow?
Is the child perspective adjustment not available in the free version of Webflow for 3D transforms?
In Webflow, when setting an Element to "Relative", how do I choose its positioning relative to other elements?
How can I display the copyright symbol © in a Webflow text block on Windows?
Can I create a square div within a parent div in Webflow, where the square's width is 100% of the parent div and the height matches the width?
Is it possible to use code in Webflow to implement scroll hijacking and have different background colors for each section on a website?
Can Webflow be used to call a CSS or JS file stored on a different server, instead of hosting them on GitHub?
How can I use the Finsweet script to manage two different sliders on my Webflow page, each feeding content from different collections?
How can I prevent a full-screen slider in Webflow from pausing on hover? Additionally, I would like to link two sliders to one control or navigation. Can anyone with JavaScript knowledge help me achieve this?
How can I change the language of publication dates in Webflow CMS collection from English to Portuguese?
How can I dynamically redirect to a CMS created after form submission in Webflow?
How can I hide the "no items found" empty field in Webflow for a second multi-image gallery on certain pages?
How can I implement swipe functionality between tab panes on mobile using custom code in Webflow?
How can I disable right-clicking on images to prevent downloading on my Webflow portfolio website?
In Webflow, how can I hide specific elements in the footer (such as "Ramin Khaze The Difference" and "Schedule showing") when the URL contains a certain parameter, such as "?mls"? I am a beginner in coding and would appreciate any help. Thank you!
How can I prevent the "w-current" class in Webflow from overriding the height of my custom class on a link block element?
Can anyone help me add a digital clock and date to my Webflow site? I've been able to add custom code, but I need assistance with styling the text. Thank you in advance for your help!
Can I capture a screenshot of a Webflow page on click and convert it to a downloadable PDF?
How can I pull the stored email from the first form submitted on our website and input it into a field on a later form during the sign-up process in Webflow? I have tried using the provided script but it only displays "undefined" in the field. I don't have much knowledge of JavaScript and found this script online.
How do I mirror user input from a form field to a non-form text field on the same Webflow page in real-time using JavaScript?
When will Webflow update the "Select Field" component to allow for a placeholder with different colors before and after selection, without the need for a label above the field?