Build Parameters provide you with flexible means of sharing settings and a convenient way of passing settings into the build.

Build parameters are name-value pairs, defined by a user or provided by TeamCity, which can be used in a build.

There are three types of build parameters:

There is a set of predefined parameters provided by TeamCity and administrators can also add custom parameters.

The parameters can be defined at different levels (in order of precedence):

Any textual setting can reference a parameter which makes the string in the format of %parameter.name% be substituted with the actual value at the time of build.
If there is a reference to a parameter which is not defined, it is considered an implicit agent requirement so the build will only run on the agents with the parameter defined.

See more in the corresponding sections: Defining and Using Build Parameters in Build Configuration and Project and Agent Level Build Parameters.

{hidden-data}
Ensure these are described/linked:
- defining parameters in a build step, passing from one build step to another
- Build Parameters build tab
- dep. references
* In dedicated {{teamcity.default.properties}} file, which should be put in the VCS root.
{note}Please note that the agent's environment variables can vary depending upon which user the agent process is running. The list of environment variables available on a specific build agent can be found on the *Environment variables* tab of the *Agent Details* page.{note}

Also:
Need to separate the page "Project and Agent Level Build Parameters" (or just put all the data on parameters onto the same page)

{hidden-data}



See also:

Administrator's Guide: Configuring Agent Requirements | Defining and Using Build Parameters in Build Configuration | Project and Agent Level Build Parameters | Predefined Build Parameters