Configuration Redirects
Configuration redirects define routing rules that Vercel evaluates at build time. Use them for permanent redirects (), temporary redirects (), and geolocation-based routing.
Define configuration redirects in your framework's config file or in the file, which is located in the root of your application. The should contain a field, which is an array of redirect rules. For more information on all available properties, see the project configuration docs.
View the full API reference for the property.
Using does not yet work locally while using , but does work when deployed.
When deployed, these redirect rules will be deployed to every region in Vercel's CDN.
The /.well-known path is reserved and cannot be redirected or rewritten. Only Enterprise teams can configure custom SSL. Contact sales to learn more.
If you are exceeding the limits below, we recommend using Middleware and Edge Config to dynamically read redirect values.
| Limit | Maximum |
|---|---|
| Number of redirects in the array | 2,048 |
| String length for and | 4,096 |
Was this helpful?