Webflow sync, pageviews & more.
NEW

How can I create and upload a apple-app-site-association file and JSON file inside a ".well-known" folder in Webflow?

TL;DR
  • Webflow can't host .well-known/apple-app-site-association, so use an external host like Netlify, Vercel, or Firebase to serve the file with proper headers.
  • Either set up a reverse proxy to serve the file alongside your Webflow site or host it on a subdomain and point Universal Links there.

To enable app-to-website association (like Universal Links) in Webflow, you need to host a .well-known/apple-app-site-association file. Webflow currently does not support hosting server-level static files or folders like .well-known.

Here’s what you can (and can’t) do:

1. Understand Webflow’s Hosting Limitations

  • Webflow does not allow direct file uploads to custom directory paths like /.well-known/.
  • Files uploaded through the Assets panel are processed and stored in Webflow’s CDN, with renamed URLs.
  • You cannot control the headers or content type (important for the apple-app-site-association file which must be served as application/json, without redirects or extensions).

2. Workaround: Use a Reverse Proxy Or External Hosting

To serve this file properly, you'll need to use an external service or set up a middleware proxy. Here are two options:

Option A: Use a Reverse Proxy with a Subdomain

  • Host your site on a reverse proxy using services like Cloudflare Workers, Firebase Hosting, or Netlify.
  • Serve your Webflow site on the root path (/) and route requests to /.well-known/apple-app-site-association to your JSON file.
  • This lets you serve the required file while preserving Webflow design and CMS.

Option B: Host the File on a Subdomain

  • Create and host the apple-app-site-association file on an external HTTPS server (e.g., AWS S3 + CloudFront, Netlify, Vercel).
  • Point a subdomain like links.yourdomain.com to the external host.
  • Configure Universal Links to check that domain instead of your main one.

3. JSON Requirements

  • File must be served with no redirects and a Content-Type: application/json header.
  • File name must be exactly apple-app-site-association (no .json extension).
  • Make sure the content follows Apple's format: associate your app’s appID, paths, etc.

Summary

Webflow cannot serve .well-known files natively. To set up an apple-app-site-association file, you must use an external hosting service or proxy to serve it properly with the correct directory path and headers. A common and reliable approach is to use Netlify, Vercel, or Firebase Hosting with a custom subdomain or reverse proxy setup.

Webflow Resources
Webflow templates
Webflow inspiration
Rate this answer

Other Webflow Questions

Explore Logic tutorials
Can Webflow be integrated with a custom-built NodeJS backend for creating a custom UI widget based on server responses?
How can I embed a clean, video with a play button on a website created in Webflow without displaying any extra graphics or suggestions from YouTube or Vimeo?
What could be causing the forms on my friend's Webflow website to stop working suddenly, even though no recent changes have been made to the forms?
Can custom content like buttons, custom components, image grids, etc., be placed within Rich Text elements in the Webflow CMS for a blog-like website? How can this limitation be overcome for a more flexible design and layout?
How can I automate the upload and updates of image resources on a Webflow collection item from an Airtable base?
Why did the checkout button disappear after connecting PayPal and enabling checkout on my Webflow website?
How can I have a different navigation bar on page 2 and page 3 in Webflow without affecting the navigation bar on page 1?
Can adsense be easily integrated into a Webflow website like it can be with Wordpress, and if so, can someone direct me to the right resources? P.S. I do not have any other hosting options.
Which shopping cart integrates well with Webflow for a custom lighting company that wants to allow visitors to purchase lighting fixtures "as shown" on the website? Thank you!
How can I embed a webpage using "iframe src" in Webflow if nothing is showing up?
How can you automate SEO and Open Graph settings for Collections in Webflow CMS to save time managing them for every page of your content-heavy website or blog?
Has anyone found a way to create a copy to clipboard button in Webflow that can dynamically copy the link of a CMS item without manually creating a link for each button? Thank you!
How can I update the thumbnail that appears when sharing my Webflow site link on SMS or social media messengers to be a thumbnail of my site?
Can I build a new site on Webflow and forward it to a subdomain of my existing website?
What is the current best workaround in Webflow for adding a "select country" list into forms, without using ecommerce and considering limitations on maximum number of items and characters for custom code?
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 dynamically redirect to a CMS created after form submission in Webflow?
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 I capture a screenshot of a Webflow page on click and convert it to a downloadable PDF?
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?
How can I close a dropdown in Webflow when clicking on a link?
Is there a more optimal way to create a portfolio section with a sticky image container that changes as you scroll, similar to the design on Deveb's website, that works across different web browsers, especially Safari, using Webflow or any other JavaScript tools?
How can I implement a multi-select field with a pre-selected option in a popup form on a collection page using Webflow?
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?