Getting Started

Learn how to use bulk redirects to manage thousands of redirects that do not require wildcard or header matching functionality.

1. Create a redirect file in one of the supported formats (CSV, JSON, or JSONL)
2. Configure the bulkRedirectsPath property in your vercel.json file
3. Deploy your project

1. Create your redirect file

   You can create fixed files of redirects, or generate them at build time as long as they end up in the location specified by bulkRedirectsPath before the build completes.

   redirects.csv

   source,destination,permanent
   /old-blog,/blog,true
   /old-about,/about,false
   /legacy-contact,https://example.com/contact,true

2. Configure bulkRedirectsPath

   Add the bulkRedirectsPath property to your vercel.json file, pointing to your redirect file. You can also point to a folder containing multiple redirect files if needed.

   vercel.json

   {
     "bulkRedirectsPath": "redirects.csv"
   }

3. Deploy

   Deploy your project to Vercel. Your bulk redirects will be processed and applied automatically.

   vercel deploy

   Any errors processing the bulk redirects will appear in the build logs for the deployment.

Each redirect supports the following fields:

In order to improve space efficiency, all boolean values can be the single characters t (true) or f (false) while using the CSV format.

For complete configuration details and advanced options, see the bulkRedirectsPath configuration reference.