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
How can Webflow users set up paginated collections using the jquery-pjax library to create a smoother browsing experience?
Can I change the Published On date of blog posts in Webflow when transferring from WordPress?
Why is the filtered checkbox not working when I click on each profession in Webflow? And why is the collection list I created in the multi-reference field not showing in the Collection List I created, requiring me to use options for the collection?
How can I add user input to the end of the redirect URL in Webflow?
How can I configure Webflow forms to exclude empty or unchecked checkboxes when sending emails? Additionally, is it possible to customize the email text for checked checkboxes, such as using "réservé" instead of "true"?
What are some free alternatives to using Google Sheets and Google Data Studio to create a responsive, filterable, and sortable dynamic table on a simple website built with Webflow?
How can I create a form in Webflow with information from my CMS, and set unique names for all the fields to avoid issues with checkboxes displaying incorrectly and receiving random field numbers in emails?
Does Webflow support the implementation of AMP, Accelerated Mobile Pages?
What is the best way to create a yellow line under the menu-item 'Projects' on the 'Projects' page in Webflow?
How can Webflow websites be translated using Localize?
Is it possible to set the viewport in Webflow's code to address the mobile usability issue flagged by Google Search Console? Is this warning something I should be concerned about? Thank you!
Is it possible to upload pictures and information onto a Webflow website, display them, have a payment system for buying services, a notification/chat system, and a search system to find specific services? If so, how can this be done using Webflow's standard e-commerce plan or a third party tool?
How can I add a close button to the nav menu in Webflow for mobile devices to make it easier to close? The default menu covers the hamburger icon and doesn't provide an easy way to close it. Adding a margin to the menu also prevents the hamburger button from closing it. Any advice on how to solve these issues?
How can I use arrow keys to change slides in Webflow using key codes?
Do all links in my Webflow website need to be in the format of https:// for them to work properly, or do I have any settings configured incorrectly?
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?