How to fix 404 errors on Squarespace
Squarespace 404s appear when you change a page's URL slug, delete pages, or migrate a site. Squarespace handles redirects through 'URL Mappings' with a specific syntax — here's how to write them correctly and how to catch broken URLs automatically.
Why 404 errors happen on Squarespace
- A page or blog post URL slug was changed, so the old path no longer resolves.
- Pages were deleted while old links still point to them.
- You migrated to Squarespace and the previous URL structure changed.
- External links or Google results reference removed URLs.
How to fix 404 errors on Squarespace, step by step
- 1
Open URL Mappings
In your Squarespace site, go to Settings → Advanced → URL Mappings.
- 2
Write a redirect using the mapping syntax
Add one rule per line using the format: /old-url -> /new-url 301. The '301' marks it as a permanent redirect. Example: /old-blog-post -> /journal/new-post 301
- 3
Use wildcards for patterns
You can use a wildcard to move a section: /blog/[*] -> /journal/[*] 301 redirects everything under /blog/ to the matching path under /journal/.
- 4
Save and test
Click Save, then visit an old URL to confirm it 301-redirects correctly.
Automatically rescue every 404 on Squarespace
URL Mappings only cover redirects you've written. Redirect Mapper adds a snippet via Settings → Advanced → Code Injection that detects any 404 in real time and redirects the visitor to the closest live page from your sitemap automatically, logging every broken URL so you can add permanent Squarespace mappings later.
Frequently asked questions
Squarespace URL Mappings use the format '/old-url -> /new-url 301', one rule per line, where 301 means a permanent redirect. You can also use wildcards, e.g. '/blog/[*] -> /journal/[*] 301', to redirect an entire section.