Bulk redirects
Bulk Redirects are available on Enterprise and Pro plans
With bulk redirects, you can handle thousands of simple path-to-path or path-to-URL redirects efficiently. Store your redirects in CSV, JSON, or JSONL files and import them using the bulkRedirectsPath field in vercel.json. They are framework agnostic and Vercel processes them before any other route specified in your deployment.
Use bulk redirects when you have thousands of redirects that do not require wildcard or header matching functionality.
- Review Getting Started to set up bulk redirects.
bulkRedirectsPath 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.
We recommend using status code 307 or 308 to avoid the ambiguity of non GET methods, which is necessary when your application needs to redirect a public API.
Each project has a free configurable capacity of bulk redirects, and additional bulk redirect capacity can be purchased in groups of 25,000 redirects by going to the Advanced section of your project's settings. At runtime, requests served by bulk redirects are treated like any other request for billing purposes. For more information, see the pricing page.
| Plan | Included in plan | Price for additional capacity |
|---|---|---|
| Pro | 1,000 | $50/month per additional 25,000 |
| Enterprise | 10,000 | $50/month per additional 25,000 |
- Bulk redirects do not support wildcard or header matching
- Bulk redirects do not work locally while using
vercel dev - A maximum of 1,000,000 bulk redirects can be configured per project.
Was this helpful?