# Adding llms.txt to a Squarespace site

> Squarespace won't serve a file at your site root, so /llms.txt 404s. The fix is a URL Mapping redirect — here are the exact steps and how to verify it.

Squarespace won't let you drop a file at the site root, but it does let you upload one and redirect `/llms.txt` to it with a URL Mapping. The result is an [llms.txt](/guide/what-is-llms-txt) crawlers can reach.

## 1. Write and upload the file

Create your `llms.txt` (a title, a one-line summary, your key pages under H2 headings). Upload it through Squarespace's file/asset manager — for example via any page's link editor, which stores it at a CDN path and gives you that URL.

## 2. What to actually put in it

Keep it curated: a title, a one-line summary as a blockquote, then your best pages grouped under H2 headings with a short description after each link. For a typical Squarespace site that means services, about and contact — plus any real content like a blog or portfolio:

```
# Studio Name

> Brooklyn design studio. These links cover our services, work and contact details.

## Services
- [Brand identity](https://example.com/services/brand): What the engagement includes
- [Web design](https://example.com/services/web): Process and typical timelines

## About
- [Studio](https://example.com/about): Team and approach
- [Contact](https://example.com/contact): How to start a project
```

Use absolute `https://` URLs — relative paths are the single most common reason a file fails validation. Full format details: [how to create an llms.txt file](/guide/how-to-create-llms-txt).

## 3. Redirect /llms.txt to it with a URL Mapping

Go to **Settings → Developer Tools → URL Mappings** and add a line that 301-redirects the root path to your uploaded file:

```
/llms.txt -> /s/llms.txt 301
```

Replace `/s/llms.txt` with the actual asset URL Squarespace gave you, then Save. A crawler requesting `/llms.txt` now follows the redirect to your file.

## 4. Help crawlers find it

Add a link to `/llms.txt` in your footer, and — if you can inject head code — a `<link rel="describedby" href="/llms.txt">`. This makes the file discoverable from your pages.

## 5. If /llms.txt still doesn't load

Three things account for almost every failure here:

  - **The asset URL moved.** If you upload a new copy instead of replacing the existing asset, the new file can land at a different URL — and the mapping still points at the old one. Copy the current asset URL and update the mapping.

  - **The mapping isn't firing.** Request the path and follow the redirect: you should see a 301 to your asset, then the file itself.

  - **You're seeing a cached miss.** If you tested the URL before the mapping existed, your browser or a CDN may still be serving that earlier 404. Retry in a private window.

```
curl -sIL https://yourdomain.com/llms.txt | grep -Ei "^HTTP/|^location:"
```

## 6. Validate

Paste your domain into the [validator](/). It follows the redirect, checks the structure, and confirms every linked URL resolves — so you know agents get a clean file. On a different builder? See [llms.txt for Wix](/guide/llms-txt-for-wix) or [Webflow](/guide/llms-txt-for-webflow).