Using static HTTP redirects in Statamic v3

Published under Statamic

Statamic includes a built-in mechanism for setting up 301 and 302 HTTP redirects. If you need to setup permanent or semi-permanent redirects (from within config files), you can do so in the config/statamic/routes.php file.

To setup permanent (301 response code) redirects, add the routes to a redirects key:

'redirect' => [
    '/old' => 'https://some-external-url.com',
    '/old-slug' => '/new-slug'
],

However, if you want to setup a temporary (Statamic calls in "vanity") redirect (302 response code), add the routes to a vanity key:

'vanity' => [
    '/temp-url' => '/some-new-temp-url',
],

If you're looking to setup dynamic redirects that you can manage from within the CMS, check out my post on Setting up dynamic HTTP redirects with Statamic v3.