Site Redirects

Redirects (Retour)

What handles redirects on this site?

Redirects are managed with the Retour plugin (by nystudio107). It lets you create and manage redirects, and it also tracks 404 (page-not-found) errors so you can fix broken links.

Earlier versions of this manual referenced a different redirect plugin (Dolphiq Redirect). That plugin was replaced by Retour during the Craft 5 upgrade.

What is a 301 redirect?

A 301 is the server’s way of telling a browser that a page has permanently moved to a new URL; the browser then loads the new location. Use a 301 when a page’s URL changes so existing links and search results keep working. More detail: MDN — 301 Moved Permanently.

How do I add a redirect?

  1. Open Retour in the CP sidebar.
  2. Go to Redirects and click + New Static Redirect (use a static redirect for a specific old URL → new URL).
  3. Enter the Legacy URL Pattern (the old path, e.g. /old-page) and the Redirect URL (the new path, e.g. /new-page).
  4. Leave the match type as Exact Match unless you specifically need a regex match.
  5. Save.

How do I find broken links to fix?

Retour’s Dashboard and 404s views list page-not-found hits. Reviewing these regularly is a good way to spot links worth redirecting.

Official documentation

Retour documentation.