Adding llms.txt to a Squarespace site
Published: · Updated:
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 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.
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 or Webflow.