Workflow Variables

About Workflow Variables

You can define personal variables for use in workflow expressions. Variables you create here are available in your workflows through the var context — for example, ${{ var.MY_VARIABLE }}.

Personal variables are separate from your organization's variables, which use the org context and are managed by organization admins. For more information, please see Organization Workflow Variables.

Adding a Variable

Navigate to your account settings (Username > Account). On the next page, click Variables.

Click Add variable.

In the dialog box that appears, enter a Key (letters, numbers, underscores, and hyphens only — for example, MY_API_KEY) and a Value. Click Save. A dialog box with the message Variable created will appear.

Variables are stored as secrets by default: their values are masked in the variables table and can't be viewed again after saving.

Editing and Deleting Variables

To change a variable's value, click the edit icon in its row, enter the new Value, and click Save. A variable's key can't be changed after creation; to rename a variable, delete it and create a new one.

To delete a variable, click the delete icon in its row. A dialog box will appear; click Delete to confirm.

Using Variables in Workflows

Reference your variables in any workflow definition with the var context:

jobs:
  main:
    steps:
      - name: Run
        run: echo ${{ var.MY_VARIABLE }}

For more information about contexts and expressions, please see Inputs and Expressions.