Getting Started

Bulk redirects can be specified either as part of a Vercel deployment or updated immediately through the UI, API, or CLI by settings redirects at the Project level without the need for a new deployment.

• Deployment-time redirects
• Project-level redirects

Bulk redirects in deployments are specified in the field in . can point to either a single file or a folder with up to 100 files. Vercel supports any combination of CSV, JSON, and JSONL files containing redirects, and they can be generated at build time.

Learn more about bulk redirects fields and file formats in the project configuration documentation.

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.

2. Configure bulkRedirectsPath

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

3. Deploy

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

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

Project-level redirects let you create and update bulk redirects without needing to redeploy. Redirects are staged when created and can be immediately published to production without a new deployment.

1. Navigate to the Redirects tab

   From your dashboard, select your project and click the Redirects tab.

2. Create a redirect

   Click Create and enter the following:

   • Source: The path to redirect from (e.g., )
   • Destination: The path or URL to redirect to (e.g., )
   • Status code: Select (temporary) or (permanent)

   You can also configure whether the redirect should be case sensitive (default ) or whether query parameters should be preserved (default ).

3. Test your changes

   New redirects are staged until you publish them. From the review redirects dialog, click on the source path for each redirect to open a staging URL where the new redirects are applied.

4. Publish your changes

   After testing your redirects, click Publish to make your changes live.

To edit or delete a redirect:

1. From the Redirects tab, find the redirect you want to modify.
2. Click the three dots menu on the right side of the redirect row.
3. Select Edit or Delete.
4. Click Publish to apply your changes.

You can upload multiple redirects at once:

1. From the Redirects tab, click the Create button and click CSV.
2. Select a CSV file containing your redirects.
3. Review the changes and click Publish.

You can manage redirects using the Vercel CLI. Make sure that you are using at least version of the CLI.

You can also manage redirects programmatically through the Vercel REST API. This is useful for automating redirect management from webhook events, such as managing redirects in a CMS and instantly updating Vercel with changes.