Add an environment variable to a Vercel project

Preconditions

• The browser session is signed in to Vercel
• The account can access the {{project}} project settings

Variables

Supplied by the executing agent at run time. The registry never stores values.

• {{project}}textVercel project name
• {{key}}textEnvironment variable name
• {{value}}secretEnvironment variable value (treat as sensitive)

Steps

1. 01
   Navigate

   Open the {{project}} project's environment variables settings

   https://vercel.com/~/{{project}}/settings/environment-variables

2. 02
   Act

   Type {{key}} into the 'Key' field of the new variable form

3. 03
   Act

   Type {{value}} into the 'Value' field

4. 04
   Actoptional

   Leave all environments (Production, Preview, Development) selected unless instructed otherwise

5. 05
   Act

   Click 'Save'

6. 06
   Verify

   Confirm the variable now appears in the list

   Expect: A row with key {{key}} is visible in the environment variables table

Success criteria

• The environment variables list shows {{key}} for the selected environments

Known failure modes

• If Vercel warns the key already exists

  Do not overwrite silently; report a partial outcome noting the variable already exists