The grammar in one line
Every Squarespace URL Mapping has three parts separated by single spaces: a source path, the literal arrow `->`, a destination, then a status code. The source is a relative path starting with /. The destination is either a relative path starting with / or a full URL starting with https://. The status code is 301 or 302. Whitespace is significant — one space on each side of the arrow, one space before the status code. Extra whitespace, missing whitespace, or any other arrow shape rejects on save.
Status codes accepted
Two status codes are accepted: 301 (permanent) and 302 (temporary). Every other code — 303, 307, 308, even 200 — rejects on save with a syntax error. Use 301 for permanent URL moves. Google passes full PageRank through 301s and treats them as the canonical permanent-move signal. Use 302 only when the move is genuinely reversible — a temporary maintenance page, a soft-launch redirect that you plan to roll back.
Wildcards and placeholders
Squarespace supports placeholder syntax with square brackets. A rule like /blog/[slug] -> /journal/[slug] 301 matches any URL under /blog/ and passes the path segment through to /journal/. The bracketed name is just a label — Squarespace uses it to capture the matched segment, not to validate the value. Multiple placeholders in one rule are supported: /shop/[category]/[product] -> /[category]/[product] 301 captures both segments and passes them through unchanged.
External targets
A destination can be a full URL on a different domain. The constraint: the destination must begin with https:// (http:// is rejected on save), and the URL must resolve to a real hostname. Squarespace does not validate that the destination URL itself returns a 200, but it does check that the URL is well-formed and uses HTTPS. Use external redirects for booking platforms, payment processors, or any case where you want a vanity URL on your Squarespace domain to redirect to a third-party host.
Order of precedence — top-down match
Squarespace evaluates the URL Mappings panel top-down: the first rule whose source pattern matches the incoming URL wins. This means rule order changes behaviour. A wildcard placed near the top of the panel absorbs URLs that more specific rules lower in the panel were meant to catch. The fix is reordering: specific rules at the top, wildcards at the bottom.
What the panel rejects on save
Squarespace's URL Mappings validator rejects rules on save with a line-number error when any of these conditions fail. The panel highlights the offending line and the rest of the panel does not save until the error is resolved. Most rejections come from one of seven patterns. Knowing the list shortens debugging from minutes to seconds.