Skip to content
Last updated on June 5, 2023
5 min read

Managing Edge Configs with the Dashboard

Learn how to create, view and update your Edge Configs and the data inside them in your Vercel Dashboard at the personal account, team, and project levels.

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

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

  1. Make sure that you are in the right personal account or team

  2. Click on the Edge Config tab

  3. Click the Create Store button

  4. Type a name for your Edge Config in the dialog and click Create. The name shouldn't exceed 32 characters and can only contain alphanumeric letters, "_", and "-".

  5. On creation, you are taken to the my_edge_config_id config page. By default, a key-value pair of "greeting": "hello world" is created. On the detail page of the newly created Edge Config you can:

    • View and manage stored items
    • Connect projects to and disconnect projects from this Edge Config
    • Generate, copy, and delete tokens associated with this Edge Config

Your Edge Config is now ready to be used. You can also create an Edge Config at the project level.

Note: If you're creating a project at the account-level, we won't automatically create a token, connection string, and environment variable until a project has been connected.
  1. Navigate to your project page and click on the Edge Config tab

  2. Click Create Project Store and type a name slug for your Edge Config in the dialog that opens. The name shouldn't exceed 32 characters and can only contain alphanumeric letters, "_", and "-".

  3. Click Create.

  4. Once created, you can click on the Edge Config to manage it. The following items are automatically created:

    • An environment variable EDGE_CONFIG that holds a connection string. If you go to your projects's Settings > Environment Variables, you'll see the newly created environment variable.
    • A read access token. This token, along with your EDGE CONFIG ID is used to create a connection string. This connection string is saved as the value of your EDGE_CONFIG environment variable. Using this enables you to use the SDK in your project to read the contents of the store.

To view a list of all Edge Configs available in your personal account or team, go to Storage then select Edge Config the 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.

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.