Validating String Parameter Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID validating-string-parameter Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
2.3 (archives)
Feb 04, 2015
Source Code
Issue Tracking
Pull Requests
Open Issues
Pull Requests
Peter Hayes (id: petehayes)
Usage Installations 2014-Nov 1271
2014-Dec 1272
2015-Jan 1311
2015-Feb 1322
2015-Mar 1424
2015-Apr 1454
2015-May 1451
2015-Jun 1503
2015-Jul 1599
2015-Aug 1592
2015-Sep 1656
2015-Oct 1688
The validating string parameter plugin contributes a new parameter type to Jenkins that supports regular expression validation of the user's entered parameter.


This plugin is used wherever build parameter selection is available, most commonly in the job configuration page by enabling parameterized builds (this parameter type will also be available as release parameters using the release plugin).

Configure the parameter by entering a name, regular expression to validate the entered value and optionally a default value, an error message shown when the user entered value fails the regular expression check and a parameter description.

When a build is requested, the user will be prompted with the parameters to enter.  Users enter the parameter as normal, but will now be prompted with an error message if the entered value does not meet the regular expression.

Once the entered value meets the configured regular expression, the error message is no longer displayed.

Version History

Version 2.4 (TBD)

Version 2.3 (04-Feb-2015)

  • Fixed links to regex pattern documentation
  • Use codemirror for the description field

Version 2.2 (13-Sep-2011)

Version 2.1 (27-Feb-2011)

  • If an invalid value is passed to the build, the build will be aborted and an error message will display in console indicating the parameter and failing value

Version 2.0 (19-Feb-2011)

  • Migrated code to jenkins and performed release

Version 1.4 (13-Oct-2010)

  • JENKINS-7794 validation check doesn't work if Jenkins is hosted with a context root

Version 1.3 (22-May-2010)

  • JENKINS-6158 Build will fail if invalid parameter is passed
  • JENKINS-6160 Jenkins will record regex used to validate the build parameter as part of build configuration and display as tooltip on the parameter page.

Version 1.2 (29-Aug-2009)

  • Used the javascript function encodeURIComponent to properly handle characters within the user entered values for regex and validation error message. (Issue 4334

Version 1.1 (28-Aug-2009)

  • Supported the release plugins as well as any other plugin that uses build parameters

Version 1.0 (24-Aug-2009)

  • Initial Version



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

Add Comment