Well known files

Well-known files enable functionalities like Apple app site association, Apple Pay, and Android link verification. Additional use cases include publishing a security.txt file, which provides contact information for reporting website security vulnerabilities.

Features

This feature is available exclusively on Pro and Enterprise plans. You can host up to 30 well-known files per project, stored under the /.well-known/ path. Both TXT and JSON files are supported, but subfolders within this path are not.

File naming conventions

Uploaded files must follow naming conventions required by third-party services. For example, for Apple app site association, the file must be named apple-app-site-association and accessible at example.com/.well-known/apple-app-site-association (with no file extension). For Android asset links, the file must be named assetlinks.json and accessible at example.com/.well-known/assetlinks.json. Incorrect naming, such as omitting the .json extension, will cause issues.

If a file is uploaded with trailing spaces or special characters (e.g., security .txt), these will be automatically removed, resulting in a corrected name like security.txt.

How to upload Well-Known Files

To upload well-known files, go to your project settings and locate the well-known files section. Upload your TXT or JSON files here. After publishing your site, the files will be accessible via the /.well-known/ path.

By following these guidelines, you can easily integrate third-party services with your Framer site.