Build Name Setter Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID build-name-setter Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
1.5.1 (archives)
Nov 13, 2015
token-macro (version:1.5.1, optional)
Source Code
Issue Tracking
Pull Requests
Open Issues
Pull Requests
Kohsuke Kawaguchi (id: kohsuke)
Lev Mishin (id: Le0)
Usage Installations 2014-Nov 6432
2014-Dec 6520
2015-Jan 6815
2015-Feb 7160
2015-Mar 7643
2015-Apr 7813
2015-May 8018
2015-Jun 8417
2015-Jul 8839
2015-Aug 8963
2015-Sep 9430
2015-Oct 9789

This plugin sets the display name of a build to something other than #1, #2, #3, ... so that you can use an identifier that makes more sense in your context. When you install this plugin, your job configuration page gets additional setting that lets you specify a build name for each new build.

You'll normally use some tokens that evaluates dynamically to some interesting values, such as the unique sequential number, Subversion revision ID, git branch name, formatted build timestamp, etc. The token expansion mechanism is provided by the Token Macro Plugin and therefore extensible. You can click the help button on the right to see the tokens available in your Jenkins.

You also could set a build name at any point of the build process in order to do that just add a setter build step to your job:
New build name consists of text file content and macro (which is also evaluated using Token Macro Plugin):


you could change the order bu checking a checkbox "Insert macro first" so build will be:


After the build name is set it looks like this:

Also note that the build name can be manually modified any time through the UI. People interested in this plugin may be also interested in the Description Setter Plugin, which does similar things for build description and instead of the name.


Version 1.5.1 (Nov 11, 2015)

  • Fixed bug with file name check (requires Jenkins 1.426)

Version 1.5 (Nov 3, 2015) is potentially broken

  • Added setter build step to set build name at any point of the build process (requires Jenkins 1.426)

Version 1.3 (Aug 2, 2011)

  • Made to work correctly with matrix projects (requires Jenkins 1.426)

Version 1.2

  • Added description for update center

Version 1.0 (Mar 1, 2011)

  • First release


plugin-buildwrapper plugin-buildwrapper Delete
token-consumer token-consumer Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Add Comment