• Products
  • Documentation
  • Resources

Create a version

Versions represent points in time for your project. They can be used to schedule how features are rolled out to your customers, or as a way to organize work that has been completed for the project.

Enable releases

In Jira Software, you create versions using the releases feature. If the releases feature isn’t enabled in your project yet, you can turn it on.

You must have project administrator permissions to enable features.

To enable the releases feature:

  1. Go to Project settings > Features.

  2. Toggle Releases on.

Create a version

You must have project administrator permissions to create a version.

  1. From your project’s sidebar, select Releases.

  2. Select Create version.

When you create a version, you can enter the:

  • Name: choose a name that’s easily identifiable for your teammates so they can recognise the version.

  • Start date: the date work on the version will start.

  • Release date: the planned release date for the version.

  • Description: more information about what you plan to release in the version.

  • Driver: someone in your team with administrator permissions who’s responsible for coordinating the release from start to finish (by default, it’s the person who creates the version).

Add a custom section with rich text

To add a custom section of text, you must have permission to resolve issues and edit issues. How to manage project permissions

Customize your release by adding a section of your own text. You can add rich text, lists, hyperlinks, dates, and emojis; and you can format the text with bold, italics, and colors.

To add rich text to your release:

  1. From your project’s sidebar, go to Releases.

  2. Select your release from the list.

  3. Select "Give this section a name" and enter a heading.

  4. Select "Add your own text here..." and enter some body text.

To add related work, you must have permission to resolve issues and edit issues. How to manage project permissions

Add related work to your version so team members and stakeholders can easily find it. This can include things like release notes, analytics dashboards, designs, support documentation, and more.

To add related work to your version:

  1. From your project’s sidebar, select Releases and go to your version.

  2. Select Add… in the Related work section.

  3. Enter the URL for the related work, a description, or both.

  4. Choose a category and select Save.

Once you’ve added related work, select the menu icon () next to an item and go to Edit to update it, or Remove to delete it.

If your related work items are not ready yet, you can create a placeholder and add the URL later when the work is available.

If you need someone to work on an item for your release, link an issue to the related work and assign it to them. To link a new issue, hover over the related work item and select Create issue, or select Link issue to link an existing issue.

Add an approver to a version

Make sure the right team members sign off on your release by adding them as an approver. Approvers can approve or decline a release, and add a reason to a decline so the team knows what has to change.

  1. From your project's sidebar, select Releases.

  2. Select a release from the list.

  3. In the Approvers section, select Add approver ().

  4. Select an approver from the list of project members, and add an optional description to let them know what they are approving.

Additional Help