Managing Edge Configs with the DashboardLearn 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:
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 for your Edge Config in the dialog and click Create. The name shouldn't exceed 32 characters and can only contain alphanumeric letters, "_", and "-".
On creation, you are taken to the
my_edge_config_idconfig 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.
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. The name shouldn't exceed 32 characters and can only contain alphanumeric letters, "_", and "-".
Once created, you can click on the Edge Config to manage it. The following items are automatically created:
- An environment variable
EDGE_CONFIGthat 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_CONFIGenvironment variable. Using this enables you to use the SDK in your project to read the contents of the store.
- An environment variable
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.
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.
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.
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.
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.