Skip to content

Does Vercel support permanent redirects?

The Vercel platform supports both 301 permanent redirects and 308 permanent redirects. Both permanent redirects are supported for domain redirects and in-application paths.

This article covers how to achieve either a permanent or temporary redirect with domain redirects or in-application paths.

Domain Redirects

To add a domain redirect, simply click the Edit button on a domain from your project's Domain settings.

A domain redirect that redirects requests made to www.came.com to acme.com.

A domain redirect can be temporary or permanent by specifying a status code. For more information about the different redirect status codes, you can check out our Redirect Status Codes documentation.

In-Application Redirects

To add an in-application redirect, you can use either a next.config.js configuration file for Next.js projects, or a vercel.json configuration file for all other use cases.

Next.js Redirects

module.exports = { async redirects() { return [ { source: '/about', destination: '/', permanent: true, }, ] }, }

Using the redirects property in a next.config.js file.

The permanent property is a boolean to toggle between permanent and temporary redirect (default true). When true, the status code is 308. When false the status code is 307.

Other Redirects

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

Using the redirectspermanent property in a vercel.json file.

Similar to a next.config.js file, the permanent property is a boolean to toggle between permanent and temporary redirect (default true). When true, the status code is 308. When false the status code is 307.

In rare cases, you may need to assign a custom status code for older HTTP Clients to properly redirect. You can use the statusCode property instead of the permanent property, but not both.

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

Using the redirectsstatusCode property in a vercel.json file.

Couldn't find the guide you need?