Using Environment Variables with the Deploy Button
Learn how to use Environment Variables with the Vercel Deploy Button.Parameter | Type | Value |
---|---|---|
env | string[] | A comma-separated list of required Environment Variable keys. |
The Required Environment Variables parameter allows you to require users to fill in values of Environment Variables the new project needs to run successfully.
The example below shows how to use the env
parameter in a Deploy Button source URL:
https://vercel.com/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js%2Ftree%2Fcanary%2Fexamples%2Fhello-world&env=PUBLIC_API_KEY,API_SECRET_KEY
You cannot pass Environment Variable values using this parameter due to the URL being saved in the browser history, and thus not being a secure method.
Parameter | Value | Type |
---|---|---|
envDescription | A short description of the Required Environment Variables: Enter your public API Key. | String |
Parameter | Type | Value |
---|---|---|
envDescription | string | A short description of the required Environment Variables |
The Environment Variables Description parameter allows you to define a URL encoded string that describes to a user what the Required Environment Variables are used for.
The description provided through this parameter will only show if Required Environment Variables are set.
The example below shows how to use the envDescription
parameter in a Deploy Button source URL:
https://vercel.com/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js%2Ftree%2Fcanary%2Fexamples%2Fhello-world&env=PUBLIC_API_KEY&envDescription=Enter%20your%20public%20API%20Key.
Parameter | Type | Value |
---|---|---|
envLink | string | A link to an explanation of the required Environment Variables |
The Environment Variable Link parameter allows you to attach a link to external documentation that helps the user find more information about where the values for the Environment Variables can be found and what they are for.
The description provided through this parameter will only show if Required Environment Variables are set.
The example below shows how to use the envLink
parameter in a Deploy Button source URL. Make sure you provide users with a specific link instead of top-level documentation:
https://vercel.com/clone?repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Fnext.js%2Ftree%2Fcanary%2Fexamples%2Fhello-world&env=PUBLIC_API_KEY&envLink=https%3A%2F%2Fvercel.com%2Fdocs
Was this helpful?