Version properties

from v3.2

Getting started with Version properties

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:

Property types

Properties schema should have at least one property.

The following property types are supported:

  • String

  • Long

  • Double

  • Boolean

  • Date

  • 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.

Enable/disable properties

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().

versionProps() JQL

JQL function versionProps accepts the following parameters:

  1. property name

  2. property type (optional) - must be specified when there are two properties with the same name but different types are present

  3. operation

  4. property value

Property type supported operations

Property type

Supported operations

Property type

Supported operations


=, != <, >, =<, >=


=, != <, >, =<, >=


=, != <, >, =<, >=


=, != <, >, =<, >=


=, !=


=, !=