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

TL;DR
  • Apple requires the AASA file to be served at https://yourdomain.com/.well-known/apple-app-site-association without redirects and with Content-Type: application/json.  
  • Since Webflow can't host files at this path, use a proxy solution like Cloudflare Workers, AWS Lambda@Edge, or a custom subdomain with proper configuration to serve the static AASA file correctly.

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 does not natively support hosting static files at this required path, but you can implement a workaround.

​

1. Understand the Hosting Requirement

​

  • Apple requires the AASA file to be served without redirects, without authentication, and from the root domain at the exact path: /.well-known/apple-app-site-association.
  • The file must be served over HTTPS with a Content-Type: application/json (not application/json; charset=utf-8 or text/plain).

​

2. Limitations of Webflow

​

  • Webflow does not allow uploading files to arbitrary paths like /.well-known/.
  • Any file uploaded via the Webflow CMS or Assets uploader will be hosted at a system-generated path, not at the root.

​

3. Workaround Using a Proxy or Edge Redirect

​

To meet Apple’s requirements, you need to use a proxy server or CDN edge function—here are options:

​

  • Option A: Use Cloudflare Workers (Recommended)
  • Point your domain’s DNS to Cloudflare.
  • Deploy a worker that intercepts requests to /.well-known/apple-app-site-association and serves the static AASA JSON.
  • Example logic: if request == /.well-known/..., return the static JSON file with correct headers; else passthrough to your Webflow site.

​

  • Option B: Use AWS CloudFront and Lambda@Edge
  • Set up CloudFront in front of your Webflow site.
  • Use Lambda@Edge to intercept /.well-known/apple-app-site-association and return the file from S3 or inline.

​

  • Option C: Host the AASA File on Another Subdomain
  • Some apps allow you to host the AASA file on a subdomain like links.yourdomain.com, as long as the subdomain is registered in your app’s Associated Domains entitlement.
  • In that case, you can use Netlify or Vercel to host just the AASA file.

​

4. Steps to Use Cloudflare Workers

​

  • Connect your domain to Cloudflare and configure DNS to point to Webflow (A records: 75.2.70.75, 99.83.190.102).
  • Install Wrangler CLI to deploy a worker: npm install -g wrangler
  • Write a worker script that returns the AASA JSON on the right path with the correct headers.
  • Publish the worker and set a route for https://yourdomain.com/.well-known/apple-app-site-association.

​

Summary

​

Webflow cannot natively host the AASA file at the required /.well-known/ path. To enable Universal Links, host the file externally—preferably using Cloudflare Workers or similar edge functions—and serve it directly with no redirects and correct headers.

Webflow Resources
Webflow templates
Webflow inspiration
Rate this answer

Other Webflow Questions

Explore Logic tutorials
How can I reduce the vertical space between lines within a bullet point in Webflow? Can I replace the bullet points with icons on the "Services" page?
Why is my heading text in Webflow not breaking into a new line and overflowing instead?
Will the load time of my Webflow website be slow in China, even if I purchase a Chinese domain?
Can an ID be set on a parent node of a Rich Text Field in Webflow?
Can someone provide a detailed tutorial on creating a 2-page sign-up form on Webflow? Specifically, the tutorial should include information about passing data from page 1 to page 2, having a custom waiting text on the 'next page' button, adding a pause on the first 'next page' button, implementing basic validation for email and phone number, and utilizing the form success message setting. Thank you!
How can I fix the "Add expires headers" issue in GTMetrix for my Webflow site?
How can I reset the tablet and phone versions of my website in Webflow to match the PC version and remove any unknown padding?
What is the issue with the div where a YouTube video should be placed in a Webflow site?
Why is my HTML5 video not showing up when I try to embed it using the Webflow embed HTML widget, even though the video plays fine when I paste the URL into a browser? I have followed the coding guides correctly.
Can I apply the lazyload image attribute in the Webflow Designer using a regular image module instead of the embed module?
Is there a way to automate the insertion of a canonical URL tag in Webflow?
Is it possible to override background color in a Webflow symbol?
Can I create a div box with sharp corners in Webflow similar to the example shown?
What could be causing glitches in the Designer and live site of a specific Webflow project, specifically when using the CMS section, while other projects in the same account are not affected?
Is there an integrated or easy way to set up Google Analytics in Webflow to only track analytics on the production site at a custom domain and fire an event only when a user completes a successful form submission?
Can I capture a screenshot of a Webflow page on click and convert it to a downloadable PDF?
How can I alternate the layout of the image and heading for each collection item in a two-column format on Webflow?
How can I execute JavaScript code when clicking a specific button with a given ID in a Webflow project?
How can I disable the Webflow success or failure state for a sign-up form and display a custom thank you page using jQuery and the Webflow form submit state?
How can I create a vertical scrolling menu with Webflow, similar to the one on Apple's website, that switches to horizontal scrolling when the menu doesn't fit on one screen?
How can I change the language of the Google Maps embed from English to Arabic in Webflow?
How can I reduce the vertical space between lines within a bullet point in Webflow? Can I replace the bullet points with icons on the "Services" page?
How can the text color be changed for custom input fields on Webflow?
How can I add conditional visibility in Webflow to prevent a div from appearing on a published page if a CMS field is empty?
How can I stop a YouTube video from playing in the background in audio mode when I close a modal in Webflow?
How can I connect and use my JavaScript and CSS files for special functions and styles in Webflow?
How can I fix the "Ensure text remains visible during webfont load" warning in Webflow?
How can I implement a ThreeJS script as a background for my Webflow project using custom code?
How can I send data from a Webflow Form to ActiveCampaign without using Zapier? I have set the form to POST and input the form's action URL, similar to Mailchimp but it redirects me to the admin area of ActiveCampaign without sending the data. Has anyone had success with this method?
Can Webflow be used to create a "blob" elements effect in the header of a website using custom code or JavaScript?