Project Description Setter Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID project-description-setter Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
1.1 (archives)
Jun 12, 2012
token-macro (version:1.5.1)
Source Code
Issue Tracking
Pull Requests
Open Issues
Pull Requests
Bap (id: bap)
Usage Installations 2014-Nov 1221
2014-Dec 1201
2015-Jan 1236
2015-Feb 1266
2015-Mar 1335
2015-Apr 1327
2015-May 1332
2015-Jun 1373
2015-Jul 1381
2015-Aug 1367
2015-Sep 1433
2015-Oct 1436

Change log


  • Set the project description using a file in the workspace
  • Use Token Macro tokens in the file to replace dynamic values, eg ${ENV,var="JENKINS_URL"}
  • File is read and description set at the end of the build - the file can be generated during the build
  • Matrix (Multi-configuration) projects supported in Jenkins 1.426 onwards
  • Use with PegDown Formatter Plugin to format the description with Markdown and prevent XSS (by selecting SUPPRESS_ALL_HTML)


Set the default Filename and Charset in Manage Jenkins > Configure System in the section titled Project description setter defaults

Enable the plugin by checking the box next to Set a project description from a file in the workspace in the Build Environment section of a project configuration.


The location of the file relative to the workspace root
The Filename can include Token Macro tokens which will be resolved before the description is set (ie, before a Markup formatter is invoked)

Advanced options
Disable tokens

Do not parse the description file for Token Macro tokens (tokens will still be expanded in the filename field)


Select the charset (character set and character-encoding) for the file

Change log

1.1 (12/06/2012)

  • Add option to disable token parsing of the contents of the description file JENKINS-14088
  • Enable environment and build variable token replacement

1.0 (05/08/2011)

  • Initial release
Questions, Comments, Bugs and Feature Requests
Please post questions or comments about this plugin to the Jenkins User mailing list.
To report a bug or request an enhancement to this plugin please create a ticket in JIRA.


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