Vercel Edge Config
An Edge Config is a global data store that enables experimentation with feature flags, A/B testing, critical redirects, and more.An Edge Config is a global data store that enables experimentation with feature flags, A/B testing, critical redirects, and IP blocking. It enables you to read data at the edge without querying an external database or hitting upstream servers.
With Vercel's optimizations, you can read Edge Config data at negligible latency. The vast majority of your reads will complete within 15ms at P99, or as low as 0ms in some scenarios.
You can use an Edge Config in Edge Functions, Edge Middleware, and Serverless Functions.
Edge Configs are great for data that is accessed frequently and updated infrequently. Here are some examples of storage data suitable for Edge Config:
You can create and manage your Edge Config from either Vercel REST API or Dashboard. You can scope your Edge Configs to your personal account or team, and connect them to as many projects as you want.
To get started, see our quickstart.
If you'd like to know whether or not Edge Config can be integrated into your workflow, it's worth knowing the following:
- You can have one or more Edge Configs per Vercel account, depending on your plan as explained in Limits
- You can use multiple Edge Configs in one Vercel project
- Each Edge Config can be accessed by multiple Vercel projects
- Edge Configs can be scoped to different environments within projects using environment variables
- Edge Config access is secure by default. A read access token is required to read from them, and an API token is required to write to them
See our Edge Config limits docs to learn more
There are alternative solutions to Edge Config for handling A/B testing, feature flags, and IP blocking. The following table lays out how those solutions compare to Edge Config:
Edge Config vs alternatives | Read latency | Write latency | Redeployment required | Added risk of downtime |
---|---|---|---|---|
Edge Config | Ultra-low | Varies | No | No |
Remote JSON files | Varies | Varies | No | Yes |
Embedded JSON files | Lowest | Highest | Yes | No |
Environment Variables | Lowest | Highest | Yes | No |
To learn about Edge Config limits and pricing, see our Edge Config limits docs.