Static Files

Static Files is an extension of well-known files that enables new, more powerful use cases

Static files allows you to upload any files into your site and host it at any path. Use it to host PDFs on your domain, serve verification files (e.g. IndexNow API) from any path, or host media files directly on your domain. This feature is available on Pro, Scale and Enterprise plans.

How to upload a static file

  1. Open your dashboard

  2. Select your domain in the sidebar

  3. Go to the “Files” tab

  4. Click on the “+”button

  5. Upload your file and select a path for it (The path should not contain the file name, e.g., if you want to host a PDF on domain.com/pdfs/example.pdf, set the path to /pdfs)

  6. Publish your site

File types

The following table shows the supported file types. If you’d like to upload a file with an extension not listed, please contact us.

Text

Image

Audio & Video

Other

PDF

PNG

MP3

EXE

TXT

JPG

WAV

ZIP

CSV

JPEG

OGG

No extension

JSON

WEBP

MP4


XML

GIF

WEBM


MD

AVIF




ICO



Content disposition

Based on your file content type, we'll instruct the browser if it should render the file or download it. These MIME types will be rendered in the browser:

  • text/plain

  • text/xml

  • application/json

  • application/pdf

  • image/* (all image formats)

  • audio/* (all audio formats)

  • video/* (all video formats)

For all other formats, we’ll instruct the browser to download the file.

Common Examples

File Path

Description

llms.txt

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

robots.txt

Instructs web crawlers, like search engine bots, which pages or directories they should or should not access. Learn more

/.well-known/ai-plugin.json

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

/.well-known/apple-app-site-association

Enables Universal Links and Shared Web Credentials for iOS apps by allowing Apple to verify domains linked to apps. Learn more

/.well-known/apple-developer-merchantid-domain-association

Verifies the domain for Apple Pay web transactions, allowing the merchant ID to process payments securely. Learn more

/.well-known/assetlinks.json

Used for Digital Asset Links on Android, enabling app-linking and domain verification. Learn more

/.well-known/atproto-did

Declares the decentralized identifier (DID) for AT Protocol services like Bluesky, enabling secure identity resolution. Learn more

/.well-known/discord

Custom configuration endpoint for Discord integrations or bot verification, used in some community and guild configurations. Learn more

/.well-known/google-site-verification.txt

Verifies domain ownership for Google services such as Search Console or Workspace. Learn more

/.well-known/security.txt

Provides contact and vulnerability disclosure information for security researchers. Learn more

You can find more examples on Wikipedia or well-known.dev.

FAQ

Lesson FAQ

  • Can I host files at the root of my domain (like /ads.txt or /llms.txt)?

    Yes. You can upload a file and set its path so it’s served from the exact URL you need, including root-level paths.

  • How many files can I upload?

    The number of files you can upload depends on your site plan. You can check these limits on our pricing page.

  • What happens if my file type isn’t supported?

    You’ll see an error when uploading. If you need additional formats, please contact support via the link above.

  • Will the file open in the browser or download automatically?

    It depends on the file’s MIME type. Common text, JSON, PDF, image, audio, and video types will render in the browser. Other formats will download automatically.[1]

  • Can I organize files under folders like /pdfs/… or /.well-known/…?

    Yes. Set the path to a folder such as /pdfs or /.well-known, then the file will be served under that path.

Updated