Octopus Deploy Documentation

Prompted variables

Last updated

As you work with variables in Octopus, there may be times when the value of a variable isn't known and you need a user to enter the variable at deployment time. Octopus can handle this using Prompted variables.

Defining a prompted variable

To make a variable a prompted variable, enter the variable editor when creating or editing the variable. On any of the variable fields, click OPEN EDITOR:

Open variable editor

When defining a prompted variable, you can provide a friendly name and description, and specify if the value is required. A required variable must be supplied when the deployment is created and must not be empty or white space.

Prompted variable

You can identify prompted variables by looking for the icon next to the value:

Providing a value for the variable

When deploying (not creating a release), you'll be prompted to provide a value for the variable:

Required prompted variable

These variables will be ordered alphabetically by label (or name, if the variable label is not provided).

A value can also be passed to a prompted variable when using the Octopus CLI through the --variable parameter of the Deploy-Release command, or the Create-Release command when also deploying the release with the --deployto parameter.

octo deploy-release ... --variable "Missile launch code:LAUNCH123" --variable "Variable 2:Some value"

Prompted variables can be combined with sensitive variables. They will appear with a password box when creating the deployment.

Learn more

Need support? We're here to help.