Metadata plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID metadata Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
1.1.0b (archives)
Dec 16, 2013
maven-plugin (version:1.509.3)
Source Code
Issue Tracking
Pull Requests
Open Issues
Pull Requests
Robert Sandell (id: rsandell)
Tomas Westling (id: t_westling)
Usage Installations 2014-Nov 463
2014-Dec 475
2015-Jan 482
2015-Feb 506
2015-Mar 535
2015-Apr 545
2015-May 555
2015-Jun 565
2015-Jul 564
2015-Aug 562
2015-Sep 583
2015-Oct 582

This plugin allows metadata to be added to projects, builds and slaves in Jenkins.
Users can add metadata manually on a project or slave via the user interface. Metadata can also be added programmatically through a plugin.
Currently, this can be done when a build starts or when a build ends. The Metadata can then be searched for.

The main idea of the metadata plugin is to make searching for jobs and builds to behave more like a database, and act as an enabler for other plugins.
Once all the information about a project is gathered in one place, plugins can be developed to use this information, as well as to provide information.
The more plugins that provide information, the more usable data you can search for.
As an example of using the information, look at the External Resource Dispatcher plugin.

Metadata definitions and values

We differentiate between MetadataDefinitions and MetadataValues. The idea comes from the parameter setup in Jenkins.
A MetadataValue is what's set on the configuration page of a project or slave and is also what is saved for a build.

MetadataDefinitions are used by admins for making sure that certain metadata exist on all projects.
A MetadataDefinition is set up through a special configuration page, configuring a name and default value for the definition.
Once set, the MetadataDefinition will end up in all projects on the server, prompting the user to set a value for it when the project is configured.
MetadataDefinitions are then converted to MetadataValues.

Metadata types

  • StringMetadataDefinition/Value: Metadata containing string values.
  • NumberMetadataDefinition/Value: Metadata containing integer numbers.
  • DateMetadataDefinition/Value: Metadata containing date values with optional hour/minute/second values.
  • TreeNodeMetadataDefinition/Value: Metadata representing a tree of Metadata. Can contain any kind of Metadata as children, including other trees.

These are the metadata types currently available. More will be added, and plugin developers could add their own types.

Metadata for builds and environment variables.

All MetadataValues for a project will automatically get copied to each build on that project. Metadata for a project or a build can be
seen by clicking the "Metadata" link from the project or the build, respectively.

If "Expose to environment" is checked for a MetadataValue, the value will also be made available as an environment variable like this:
TreeNodeMetadataValue with name "my" with one child, a StringMetadataValue with name "string" and value "value".
This will be converted to an environment variable called MD_MY_STRING with value "value".
That is, MD (short for metadata) will be prepended, and each parent-child bond will be represented by an underscore.
These environment variables can then be used by the build.


The search functionality is accessible through the "Metadata search" link.
Currently, only searching for projects is supported, but builds and slaves will be added.
Searching is done with the syntax metadatavaluename=value && othervaluename=value2
Equals, And and Or (||) are the operators supported so far.

Metadata search view and result.
You can also add a metadata filter to a view where you can provide a search string that will filter out the jobs matching that search.


Plugin developers can add their own MetadataDefinitions and Values, by extending either AbstractMetadataDefinition/Value directly or
one of the subclasses. If possible, try to use the existing classes as much as possible when providing data from your plugin as there is
no value in lots of definitions/values that do almost the same thing but with different names.
Other than writing your own MetadataDefinitions and Values, the main way of extending the Metadata plugin is through the contributor classes.


This ExtensionPoint can be used when you want to automatically add Metadata to a project whenever the project is saved. Extend JobMetadataContributor,
add @Extension to your class, and implement the getMetaDataFor method. Return a list of MetadataValues which will then be added to the project.


This ExtensionPoint can be used when you want to automatically add Metadata to a build whenever it is finished. Extend BuildMetadataContributor,
add @Extension to your class, and implement the getMetadataFor method. Return a list of MetadataValues which will then be added to the project.

Roadmap and future

Here is a list of features we would like to see in the Metadata plugin in the future:

  • Finalized definitions support. The definitions support isn't yet fully functional, the conversion to values needs to be done.
  • Search for builds and nodes based on specific metadata.
  • Search for projects with specific metadata in a build of that project.
  • More advanced search functionality
  • Search optimization
  • Support for plugins to add metadata to nodes
  • Advanced resource selection criteria
  • More definitions and values
  • Put the metadata into some kind of database

Change Log

Version 1.1.0b (released Dec 16, 2013)

Version 1.0b (released Nov 22, 2012)

Initial beta release


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

Add Comment