Pipeline: Input Step

Adds the Pipeline input step to wait for human input or approval. A basic Proceed or Abort option is provided in the stage view.

The parameter entry screen can be accessed via a link at the bottom of the build console log or via link in the sidebar for a build.

Input Example with Message Parameter:

input 'Proceed or Abort'

Input Example with Custom identifier: Every input step has an unique identifier. It is used in the generated URL to proceed or abort.

A specific identifier could be used, for example, to mechanically respond to the input from some external process/tool.

input id: '2', message: 'input-message'

Input Example with OK Button Caption(Optional):

input message: 'input-message', ok: 'OK'

Input Example with Allowed Submitter: Usernames and/or external group names of those permitted to respond to the input, separated by ','. Spaces will be trimmed automatically, so "Alice, Bob, Charles" is the same as "Alice,Bob,Charles". Note: Jenkins administrators are able to respond to the input regardless of the value of this parameter.

input message: '', submitter: 'jenkins-user, jenkins-user2'

Input Example with Parameter to store the Approving Submitter:

If specified, this is the name of the return value that will contain the username of the user that approves this input. The return value will be handled in a fashion similar to the parameters value.

input message: 'input-message', submitter: 'jenkins-submitter, jenkins-submitter2', submitterParameter: 'approvers-id-to-be-stored'

Use the Pipeline Syntax Snippet Generator to select options for the input step. For further understanding, check the pipeline input step plugin documentation.

Version History

Please refer to the changelog