Does Vercel support permanent redirects?

The Vercel platform supports 308 permanent redirects for in-application paths only. By default, redirects made using the redirects configuration object in a vercel.json file will be given a 308 (permanent) status code.

This article covers how to use redirects to achieve either a 308 (permanent) status code or a 307 (temporary) status code.

Permanent Redirects

Below is an example vercel.json configuration file using a Permanent Redirect.

{
  "redirects": [
    { 
      "source": "/view-source",
      "destination": "https://github.com/vercel/vercel", 
      "permanent": true
    }
  ]
}

Using the redirects property in a vercel.json file.

Temporary Redirects

Below is an example vercel.json configuration file using a Temporary Redirect.

{
  "redirects": [
    { 
      "source": "/view-source",
      "destination": "https://github.com/vercel/vercel", 
      "permanent": false
    }
  ]
}

Using the redirects property in a vercel.json file.

Vercel Domains

Permanent redirects are not possible using the Vercel Domains UI currently. All redirects added from the Vercel Dashboard with result in a 307 temporary redirect status code being used. To add a redirect, simply click the Edit button on a domain from your Project Domain settings.

Redirecting vercel.org to vercel.com via a temporary redirect from the Vercel Domains UI.

Feature Request

If you would like to request support for permanent redirects for Vercel domains, please submit feedback as described here.

Updated October 7th 2020