Skip to content

Manage Edge Configs with the Dashboard

Manage your Edge Configs at different levels in your Vercel Dashboard

You can create, view and update your Edge Configs and the data inside them in your Vercel Dashboard at both the personal account or team level and at the project level.

To add an Edge Config at the personal account or team level, follow these steps:

  • Make sure that you are in the right personal account or team
  • Click on the Edge Config tab
  • Click the Create Store button
  • Type a name slug for your Edge Config in the dialog and click Create
Note: The name slug should contain alphanumeric letters, "_" and "-". It should not exceed 32 characters

You will be taken to the detail page of the newly created Edge Config where you can:

  • View and manage stored items
  • Connect and disconnect projects to and from this Edge Config
  • Generate, copy and delete tokens associated with this Edge Config
  • Navigate to your project page and click on the Edge Config tab
  • Click Create Project Store and type a name slug for your Edge Config in the dialog that opens and click Create
Note: The name can only contain alphanumeric letters, "_" and "-". It cannot exceed 32 characters.
  • Once created, you will see a summary of what was created for you. In addition to the Edge Config, the following are also created:
    • A token called web-app-token
    • A default key-value data pair greeting: "hello world"
    • An environment variable EDGE_CONFIG that holds a connection string
  • Click Show Edge Config to be taken to the Edge Config detail page

To view a list of all Edge Configs available in your personal account or team, go to the Edge Config tab after making sure that you are in the correct personal account or team.

List of Edge Configs in a team account

In the Used by column, you can see in which project(s) the Edge Config is used. The right column shows the size of the data contained in the config. To manage the Edge Config, its store and tokens, click on the Edge Config's row to open the detail page.

Edge Config detail page

To rename or delete the Edge Config, click on the horizontal ellipsis icon on the right side of the detail page and click Rename or Delete. Update the name or confirm the deletion in the dialog that opens.

List of store items

The default view of the Edge Config's detail page shows the list of all items in the store. You will see an open accordion titled Learn how to use this in code if the Edge Config is connected to at least one project. This accordion provides the steps with a code example on how to read your store items.

To add, edit or delete any item in your store, edit the json object in the right panel and click Save Items.

List of connected projects

Click on Projects in the left panel of the Edge Config detail page to open a view that shows the projects connected with this Edge Config.

To delete a connection, click on the vertical ellipsis icon on the right hand side of the row and click Delete environment variable and confirm by clicking Delete connection in the dialog.

Deleting a connection does not delete the underlying token used by that Connection String. To learn how to delete tokens, review Manage read access tokens.

To connect the Edge Config with another project, click Connect Project, find the project from the drop-down in the dialog and click Connect. If you receive a warning that this project already has an EDGE_CONFIG environment variable, open the Advanced Options and change the environment variable name in the corresponding field to a name other than EDGE_CONFIG. The Connect button will be enabled once the new enviroment variable does not already exist in the project.

List of tokens

To delete a token, click on the vertical ellipsis icon on the right hand side of the token's row and click Delete Token and confirm by clicking Delete Token in the dialog.

You can copy the connection string to be used in your code by clicking on Copy Connection String from the same pop up from the vertical ellipsis icon.

You can generate a new token by clicking the Generate Token button, typing a name slug in the dialog that opens and clicking Create.