Documentation for Bamboo 4.1.x. Documentation for earlier versions of Bamboo is available too.

When configuring a plan, you may want to specify variables to be used in the build process. For details on how variables are used, see Using global, plan or build-specific variables.

Plan variables are one type of variable that is available to you. A plan variable is defined for one specific plan, and has the same value every time that plan is built. If you want to define a variable across all plans rather than a single plan, define a global variable as described in Defining global variables.

Plan variables can be accessed by using ${bamboo.varName}. Plan variables can also be overridden at runtime when running a manual build. For more information, see Triggering a plan build manually.

Related pages:

Before you begin:

  • Note that plan variables override global variables with the same name.

To define a plan variable:

  1. Navigate to the configuration for the desired plan, as described on Editing a plan's configuration.
  2. Click the Variables tab.
  3. Add, update or delete plan variables, as desired:
    • Click Add to add a new variable once you have entered the key and value for it.
    • Updates to existing rows will be saved as you move between cells in the table.
    • Click the trash can to delete a variable.

Screenshot: Adding a plan variable

  • No labels



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.