Version properties enable users adding additional details to versions via custom properties (additional fields) and then search issues by those details using new JQL function versionProps()
Version properties are grouped into Version properties schema which is then assigned to one or several Jira projects. New version properties will be available in versions of those Jira projects which are associated with Version properties schema.
Create Version properties schema
Jira administrator can manage version properties schemes in Jira Administration → Manage Apps → Version properties:
Properties schema should have at least one property.
The following property types are supported:
User - Jira user single select
Change properties order
The list of additional fields on the version screen is the same as their order in property schema.
You can change the order of properties using drag&drop.
It is possible to disable a property in the Property schema to hide the property field on the version screen using “Enabled“ toggle.
Assign Version property schema to a project
Jira Administrator can assign Version property schema to one or several projects using Projects property on Schema screen.
Project Administrator can assign Version property schema or change schema if it was already assigned on the “Version properties“ project navigation tab.
View Version properties
When Version properties schema is assigned to a project those properties are displayed in the version list together will built-in version fields.
Edit Version properties
When creating new or editing existing version on Version properties project tab, custom version properties are available on the “Custom“ tab.
Built-in version fields like Name, Description, Start date, Release date are located on the Default tab of the version dialog.
Search issues by version properties
You can search issues by version properties using new JQL function versionProps().
JQL function versionProps accepts the following parameters:
property type (optional) - must be specified when there are two properties with the same name but different types are present