Well-known files & llms.txt
Framer supports integration with third-party services by letting you host well-known files directly on your Framer site or custom domain.
Well-known files enable features like Apple app site association, Apple Pay, Android link verification or llms.txt. You can also use them to publish a security.txt file, which provides contact details for reporting website security vulnerabilities.
This feature is available on Pro, Scale and Enterprise plans. You can host up to 30 well-known files per project, stored in the /.well-known/ path, or for llms.txt and robots.txt on the root (/). Both TXT and JSON formats are supported. Subfolders within this path are not allowed.
File naming conventions
While uploading, make sure the files meet naming conventions required by third-party services. For example:
Apple app site association: The file must be named
apple-app-site-association(no file extension) so it’s accessible atexample.com/.well-known/apple-app-site-association.Android asset links: The file must be named
assetlinks.jsonso it’s accessible atexample.com/.well-known/assetlinks.json.llms.txt: The file must be named
llms.txtso it’s accessible atexample.com/llms.txt.robots.txt: The file must be named
robots.txtso it’s accessible atexample.com/robots.txt.
Incorrect naming—such as omitting the .json extension—can cause functionality issues.
If a file is uploaded with trailing spaces or special characters (e.g., security .txt), these are automatically removed. The corrected name, such as security.txt, will be used.
How to upload well-known files
To upload well-known files:
Open your project settings.
Locate the “Well-Known Files” section.
Upload your TXT or JSON files.
Publish your site
If your site has Staging enabled, deploy the latest version
Once your site is published, the files will be available at the /.well-known/* / /llms.txt / /robots.txt path.
Common Examples
File Path | Description |
|---|---|
| Helps AI agents and LLMs to understand your website. As an example, OpenAI search, Anthropic’s Claude and Perplexity make use of it to provide better search results. Learn more |
| Instructs web crawlers, like search engine bots, which pages or directories they should or should not access. Learn more |
| Defines metadata for integrating an AI plugin, including name, authentication method, API endpoints, and logo. Used by platforms like ChatGPT for discovery and connection. Learn more |
| Enables Universal Links and Shared Web Credentials for iOS apps by allowing Apple to verify domains linked to apps. Learn more |
| Verifies the domain for Apple Pay web transactions, allowing the merchant ID to process payments securely. Learn more |
| Used for Digital Asset Links on Android, enabling app-linking and domain verification. Learn more |
| Declares the decentralized identifier (DID) for AT Protocol services like Bluesky, enabling secure identity resolution. Learn more |
| Custom configuration endpoint for Discord integrations or bot verification, used in some community and guild configurations. Learn more |
| Verifies domain ownership for Google services such as Search Console or Workspace. Learn more |
| Provides contact and vulnerability disclosure information for security researchers. Learn more |
You can find more examples on Wikipedia or well-known.dev.
How do I upload well-known files, such as llms.txt or robots.txt, to my Framer site?
To upload well-known files, open your project settings and locate the “Well-Known Files” section. Upload your TXT or JSON files there, then publish your site. If your site has Staging enabled, deploy the latest version. Once published, the files will be available at the /.well-known/*, /llms.txt, or /robots.txt path.
What are the file naming conventions and requirements for well-known files in Framer?
Files must meet the naming conventions required by third-party services. For example, the Apple app site association file must be named 'apple-app-site-association' (no extension), and Android asset links must be 'assetlinks.json'. The llms.txt and robots.txt files must be named exactly as such and are accessible at the root. Incorrect naming, such as omitting the .json extension, can cause functionality issues. Any trailing spaces or special characters in uploaded filenames are automatically removed.
What are some common examples of well-known files I can host on Framer, and what are their purposes?
Common examples include llms.txt (helps AI agents and LLMs understand your website), robots.txt (instructs web crawlers which pages to access), /.well-known/ai-plugin.json (defines metadata for AI plugin integration), /.well-known/apple-app-site-association (enables Universal Links for iOS apps), /.well-known/apple-developer-merchantid-domain-association (verifies domain for Apple Pay), /.well-known/assetlinks.json (enables app-linking for Android), /.well-known/discord (for Discord integrations), /.well-known/google-site-verification.txt (verifies domain ownership for Google services), and /.well-known/security.txt (provides contact for security researchers).
Updated