Unable to render embedded object: File (TeamCity48.png) not found.

TeamCity 9.x Documentation

Documentation for Previous Versions


You are viewing the documentation of TeamCity 9.x, which is not the most recently released version of TeamCity.
View this page in the latest documentation or refer to the listing to choose the documentation corresponding to your TeamCity version.


Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.





The build configuration name

Build Configuration ID

An The ID of the build configuration (must be unique across all build configurations and templates in the system).


An optional description for the build configuration.

Build Number Format

This value is assigned to the build number. For more information, refer to the Build Number Format section below.

Build Counter

Specify the counter to be used in the build numbering. Each build increases the build counter by 1. Use the Reset counter link to reset counter value to 1.

Artifact Paths

Patterns to define artifacts of a build. For more information, refer to the Artifact Paths section below.

Build Options

Additional options for this build configuration. For more information, refer to the following sections below:

Table of Contents
excludeExplicit Paths|Paths Patterns





a build counter unique for each build configuration. It is maintained by TeamCity and will resolve to a next integer value on each new build start. The current value of the counter can be edited in the Build counter field.


the revision used for the build of the VCS root with <VCS_root_name> name. Read more on the property.


a value of the build property with the corresponding name. All the Predefined Build Parameters are supported (including Reference-only server properties).


Though not required, it is still highly recommended to ensure the build numbers are unique. Please include the build counter in the build number and do not reset the build counter to lesser values.
It is also possible to change the build number from within your build script. For details, refer to Build Script Interaction with TeamCity.


  • file_name — to publish the file. The name should be relative to the Build Checkout Directory.
  • directory_name — to publish all the files and subdirectories within the directory specified. The directory name should be a path relative to the Build Checkout Directory. The files will be published preserving the directories structure under the directory specified (the directory itself will not be included).
  • wildcard — to publish files matching Ant-like wildcard pattern (only "*" and "**" wildcards are supported). The wildcard should represent a path relative to the build checkout directory. The files will be published preserving the structure of the directories matched by the wildcard (directories matched by "static" text will not be created). That is, TeamCity will create directories starting from the first occurrence of the wildcard in the pattern.
  • target_directory — the directory in the resulting build's artifacts that will contain the files determined by the left part of the pattern. This path is a relative one with the root being the root of the build artifacts.
  • target_archive — the path to the archive to be created by TeamCity by packing build artifacts determined in the left part of the pattern. TeamCity treats the right part of the pattern as target_archive whenever it ends with a supported archive extension, i.e. .zip, .7z, .jar, .tar.gz, or .tgz.

The source file being Although absolute paths are supported, but those configurations are not recommended in favor of it is recommended to use paths relative to the build checkout directory.

An The optional part starting with the => symbols and followed by the target directory name can be used to publish the files into the specified target directory. If the target directory is omitted, the files are published in the root of the build artifacts. You can use "." (dot) as a reference to the build checkout directory.
The target paths must not be absolute. Non-relative paths will produce errors during the build.