vercel global-config

The vercel global-config command manages Global Config stores from the CLI. It mirrors the dashboard API surface: create stores, inspect metadata, patch items in batch, list items, manage read tokens, and restore backups. For an overview of Global Config and how to read from it at runtime, see Vercel Global Config.

vercel edge-config continues to work as an alias for vercel global-config following the rename from Edge Config to Global Config.

Usage

terminal

vercel global-config [subcommand]

Using the vercel global-config command to manage Global Config stores.

Commands

list (ls)

Lists Global Config stores for the current team. Running vercel global-config with no subcommand runs list.

terminal

vercel global-config
vercel global-config list
vercel global-config list --format json

List stores. Use --format json for machine-readable output.

Options

Option	Type	Description
`-F, --format <FORMAT>`	String	Output format (`json`)

add (create)

Creates a new Global Config store with the given slug. Optionally seeds it with initial items.

terminal

vercel global-config add flags
vercel global-config add flags --items '{"betaUiEnabled":true,"region":"sfo1"}'

Create a store with slug flags, optionally with seed items.

Arguments

Argument	Required	Description
`slug`	Yes	Slug for the new Global Config store

Options

Option	Type	Description
`--items <JSON>`	String	Optional JSON object of initial items (`{ "key": <value>, ... }`)
`-F, --format <FORMAT>`	String	Output format (`json`)

get (inspect)

Shows metadata for a Global Config store. Accepts either the store ID (starts with ecfg_) or the slug.

terminal

vercel global-config get flags
vercel global-config get ecfg_abc123 --format json

Inspect a store by ID or slug.

Arguments

Argument	Required	Description
`id-or-slug`	Yes	Store ID (e.g. `ecfg_abc123`) or slug

Options

Option	Type	Description
`-F, --format <FORMAT>`	String	Output format (`json`)

update

Renames a Global Config store (--slug) and/or patches its items (--patch). For complex updates, use the batch items API shape.

terminal

vercel global-config update flags --slug feature-flags
vercel global-config update flags --patch '{"items":[{"operation":"upsert","key":"betaUiEnabled","value":true}]}'

Rename a store and/or patch items in batch.

Arguments

Argument	Required	Description
`id-or-slug`	Yes	Store ID or slug

Options

Option	Type	Description
`--slug <SLUG>`	String	New slug for the store
`--patch <JSON>`	String	Batch items payload (`{"items":[...]}` or a bare array). Each item needs `operation` (`create`, `update`, `upsert`, or `delete`), `key`, and usually `value`
`-F, --format <FORMAT>`	String	Output format (`json`)

remove (rm, delete)

Deletes a Global Config store.

terminal

vercel global-config remove flags --yes

Delete a store. Use --yes to skip the confirmation prompt.

Arguments

Argument	Required	Description
`id-or-slug`	Yes	Store ID or slug

Options

Option	Type	Description
`-y, --yes`	Boolean	Skip the confirmation prompt
`-F, --format <FORMAT>`	String	Output format (`json`)

items

Lists items in a Global Config store, or fetches one item with --key.

terminal

vercel global-config items flags
vercel global-config items flags --key betaUiEnabled

List all items, or fetch a single item by key.

Arguments

Argument	Required	Description
`id-or-slug`	Yes	Store ID or slug

Options

Option	Type	Description
`-k, --key <KEY>`	String	When set, fetch a single item by key
`-F, --format <FORMAT>`	String	Output format (`json`)

tokens

Lists, creates (--add), or revokes (--remove) read tokens for a Global Config store. Read tokens authenticate Global Config reads from your application at runtime.

terminal

vercel global-config tokens flags
vercel global-config tokens flags --add "Production read"
vercel global-config tokens flags --remove tok_abc123 --yes

List, create, or revoke read tokens for a store.

Arguments

Argument	Required	Description
`id-or-slug`	Yes	Store ID or slug

Options

Option	Type	Description
`--add <LABEL>`	String	Create a new read token with this label (1-52 characters)
`--remove <ID_OR_TOKEN>`	String[]	Revoke one or more tokens by ID or plaintext token (repeatable). Requires `--yes` in non-interactive mode
`-y, --yes`	Boolean	Skip the confirmation prompt
`-F, --format <FORMAT>`	String	Output format (`json`)

backups

Lists backups for a Global Config store, fetches a single backup version with --backup-version, or restores items from a backup with --restore.

terminal

vercel global-config backups flags
vercel global-config backups flags --backup-version backup_version_abc123 --format json
vercel global-config backups flags --restore backup_version_abc123 --yes

List, inspect, or restore backups for a store.

Restoring a backup updates live Global Config items immediately. Use --yes to skip the confirmation prompt in non-interactive environments.

Arguments

Argument	Required	Description
`id-or-slug`	Yes	Store ID or slug

Options

Option	Type	Description
`--backup-version <VERSION_ID>`	String	Fetch a single backup version by ID
`--restore <VERSION_ID>`	String	Restore items from a backup version. Cannot be used with `--backup-version`
`--limit <NUMBER>`	Number	Maximum number of backups to list (`0` to `50`)
`--next <CURSOR>`	String	Pagination cursor from a previous backup list response
`-y, --yes`	Boolean	Skip the confirmation prompt when restoring
`-F, --format <FORMAT>`	String	Output format (`json`)

Examples

Create a store and seed initial items

terminal

vercel global-config add flags --items '{"betaUiEnabled":false,"region":"sfo1"}'

Create a store with two initial items.

Patch items in batch

terminal

vercel global-config update flags --patch '{"items":[
  {"operation":"upsert","key":"betaUiEnabled","value":true},
  {"operation":"delete","key":"oldFlag"}
]}'

Apply a batch of item operations in one call. See the batch items REST API reference.

Create a read token for production

terminal

vercel global-config tokens flags --add "Production read"

Create a labeled read token. The CLI prints the plaintext token (and its ID) once; capture it before it scrolls away.

Restore a backup

terminal

vercel global-config backups flags --restore backup_version_abc123 --yes

Restore flags from a backup version and skip the confirmation prompt.

The Global Config SDK reads from a GLOBAL_CONFIG environment variable (falling back to EDGE_CONFIG) that contains a full connection string, not just the token. The connection string format is:

connection string

https://global-config.vercel.com/<globalConfigId>?token=<token>

Use vercel global-config get <id-or-slug> to look up the Global Config ID, then combine it with the token. See Global Config dashboard for details on the connection string format.

Global Options

The following global options can be passed when using the vercel global-config command:

For more information on global options and their usage, refer to the options section.

Last updated August 11, 2026

Cross-link map: vercel global-config (/docs/cli/global-config)

From the Vercel docs graph (built 2026-09-07T06:43:21.813Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

Vercel CLI Global Options — Global options are commonly available to use with multiple Vercel CLI commands. Learn about Vercel CLI's global options
vercel blob — Learn how to interact with Vercel Blob storage using the vercel blob CLI command.
Managing Global Configs with the Dashboard — Learn how to create, view and update your Global Configs and the data inside them in your Vercel Dashboard at the Hobby
Using Global Config — Learn how to use Global Configs in your projects.
Managing Global Configs with Vercel REST API — Learn how to use the Vercel REST API to create and update Global Configs. You can also read data stored in Global Config

This page links to (4)

Vercel CLI Global Options — Global options are commonly available to use with multiple Vercel CLI commands. Learn about Vercel CLI's global options
Vercel Global Config — A Global Config is a global data store that enables experimentation with feature flags, A/B testing, critical redirects,
Managing Global Configs with the Dashboard — Learn how to create, view and update your Global Configs and the data inside them in your Vercel Dashboard at the Hobby
Update Global Config items in batch — PATCH /v1/global-config/{edgeConfigId}/items — Update multiple Global Config Items in batch.

Pages that link here (3)

By site: vercel-docs (3)

Vercel CLI Overview — Learn how to use the Vercel command-line interface \(CLI\) to manage and configure your Vercel Projects from the command
Migrating from Edge Config to Global Config — Learn what changed when Edge Config was renamed to Global Config, and how to migrate your connection strings, SDK, and e
Vercel Documentation Sitemap — Browse Vercel documentation pages with summaries, prerequisites, and topics.

vercel git

vercel guidance

Was this helpful?