support.squarespace.comAbout this template
Generic SEO advice doesn't work on Squarespace
You were told to fix your title tags. So you did — and nothing changed, because Squarespace doesn't work the way the advice assumes.
Three things break it:
- There's a separate SEO Title field per page, under Page Settings → SEO.
Leave it blank and it falls back to
Page Title - Site Title. That's how a store ends up with twelve pages sharing one title. - Your Site Title gets appended to whatever you write. A 60-character SEO
Title plus
- Your Storeoverflows, so the length you typed isn't the length Google shows. - Products inherit the collection description when their own is empty. Empty product descriptions are the most common thin-content problem on Squarespace commerce, and nothing in the editor tells you.
What comes back
Give it your store URL. It pulls /sitemap.xml — public on every Squarespace
site, so there's no login and no API key — fetches each page, and reports in
leverage order, not alphabetically:
- Missing or duplicate SEO Titles
- Missing meta descriptions on pages that get traffic
- Empty product descriptions
- Near-duplicate titles across pages, grouped together
- Missing alt text
- Heading structure — multiple H1s, skipped levels
Each finding gives the URL, what's wrong, and the exact string to paste into which Squarespace field.
Every drafted title shows its rendered length including the appended Site Title. A draft that overflows isn't a draft.
Duplicates come as a group
Because fixing one in isolation just moves the collision. You need to see all three pages that resolve to "Shop - My Store" at once.
What you supply
Your own Claude Code login. That's it.
Optionally: paste a Search Console export into ~/sqsp/pages/ and "pages that
get traffic" stops being a guess.
The guard is a file, not a promise
~/sqsp/policy/SEO-RULES.md carries NEVER_AUTOEDIT, the platform traps and the
fix ordering. The skill reads it before every audit. Disagree with the ordering
for your store? Edit the file, not the prompt.
Where this stops
It reads your public pages and drafts fixes. It has no Squarespace login, can't publish, and can't edit a page — by design. The sitemap is the whole input.
It won't predict rankings without Search Console data, and it won't call a page "optimized" — it reports what's present and what's missing.
Verified on build: the skill, the working tree, the NEVER_AUTOEDIT guard and
the platform traps are present on a fresh fork. Running it on your own store is
yours to do.