Jenkins Help

Back to index
Note
This page is generated from Jenkins inline help intended to be rendered within the Jenkins UI. Some minor content glitches are expected.

Labels (or tags) are used to group multiple agents into one logical group.

For example, if you have multiple Windows agents and you have a job that must run on Windows, then you could configure all your Windows agents to have the label windows, and then tie that job to this label.
This would ensure that your job runs on one of your Windows agents, but not on any agents without this label.

Labels do not necessarily have to represent the operating system on the agent; you can also use labels to note the CPU architecture, or that a certain tool is installed on the agent.

Multiple labels must be separated by a space. For example, windows docker would assign two labels to the agent: windows and docker.

Labels may contain any non-space characters, but you should avoid special characters such as any of these: !&|<>(), as other Jenkins features allow for defining label expressions, where these characters may be used.