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
Open Issues
Peter Hayes (id: petehayes)
Usage Installations 2014-Mar 1031
2014-Apr 1045
2014-May 1042
2014-Jun 1075
2014-Jul 1157
2014-Aug 1144
2014-Sep 1192
2014-Oct 1247
2014-Nov 1271
2014-Dec 1272
2015-Jan 1311
2015-Feb 1322
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