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’s hosting doesn’t let you create custom folders (like “.well-known”) directly, which is required for files like apple-app-site-association used in universal links. To work around this, follow these steps:

  1. Prepare Your Files
    • Create the apple-app-site-association file (with no file extension) and any required JSON file ensuring they follow Apple’s guidelines (UTF‑8 encoded, valid JSON format, served with the correct Content-Type, etc.).
    • Test your files locally with a JSON validator.

  2. Choose an External Hosting Option
    • Since Webflow’s file structure can’t include a “.well-known” folder, host these files on an external server or CDN that supports custom folder structures.
    • Options include hosting on platforms like Firebase Hosting, Netlify, or even your own web server.

  3. Configure Your Domain
    • Point your domain’s DNS (or use a subdomain) to your external host so that URLs like https://yourdomain.com/.well-known/apple-app-site-association serve the correct file.
    • Ensure your external hosting configuration serves the file without redirects, as Apple requires a direct response.

  4. Verify and Test
    • Use online tools or Apple's debugging instructions (see “Supporting Universal Links” on Apple’s developer site) to confirm that your apple-app-site-association file is served correctly from the expected URL.

Tip: Although Webflow lets you upload individual files to the assets panel, these files are hosted on a different URL structure and cannot be placed in a custom “.well-known” directory.

Summary: For universal link files like apple-app-site-association, host them externally with full control over your folder structure and DNS. This ensures compliance with Apple’s guidelines while keeping your Webflow site for content and design purposes.

Webflow Resources
Webflow templates
Webflow inspiration
Rate this answer

Other Webflow Questions

Explore Logic tutorials
How can I hide the "UXmas" page on my Webflow website?
What would be a better setup for migrating our copywriter app from Bubble to Webflow, considering our requirements for saving user-generated content and potential limitations with Airtable's number of records?
Why does the video element in Webflow show an "Invalid embed type: link" error when trying to set a public video URL from S3?
How can I give access to only one specific page in a CMS collection with gated membership access in Webflow?
Why doesn't my background video display properly in the Webflow designer with the correct height?
Can I use a CMS image as a background image for a div or section in Webflow?
Can Webflow allow for custom redirect URLs for each contact form in CMS templates to create separate thank-you pages for landing pages?
How can I style the "Current" state of a menu item in Webflow using custom CSS?
What is the recommended maximum width for a Webflow div block container to fit most display screen sizes, excluding the standard 940px container, considering the large screen size of an iMac Retina?
How can I copy a perfectly designed section from one page to another in Webflow?
Can Webflow be integrated with a custom NodeJS backend using MongoDB? Any tips for this integration?
Does the "fixed" background picture property not work on iPhone 5 when using Webflow?
What shopping cart/eCommerce recommendations have you seen work well with Webflow apart from Shoplocket?
How can I create buttons in Webflow that link to specific slides in a slider? I've tried using unique IDs for the slides and images but they're not working. Thank you, David.
How can I set the default starting slide to slide 2 in a Webflow slider without sharing the read-only link?
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 fix the issue with the scroll not being smooth on my mobile device (iPhone + Safari) in Webflow?
How can I prevent scroll when my nav is open in Webflow using code? The scroll is disabled correctly when I change the class name of the second 'menu', but it does not get activated when the menu is closed. It doesn't work at all if both class names are the same. Can anyone provide assistance with this issue?
How can I add date filtering to my current list of filters in Webflow using Finsweet CMS Filtering?
How can I change the language of publication dates in Webflow CMS collection from English to Portuguese?
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"?
How can I dynamically redirect to a CMS created after form submission in Webflow?
How can I make the menu close when a link is clicked 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?
Is there a way to fix the issue of values from Textareas with multiple lines not getting parsed correctly in Webflow Logic when posting to an external API?
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!