Set up Jira Cloud
Learn how to set up Jira Cloud and integrate it with other products and applications.
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.
Before you begin
Make sure the releases feature is enabled for your project. Learn more about enabling releases and versions.
You must have project administrator permissions to create a version and add related work items.
Enable releases
In Jira, 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:
Go to Project settings, then select Features.
Toggle Releases on.
Create a version
You must have project administrator permissions to create a version.
From your project’s sidebar, select Releases.
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:
From your project’s sidebar, select Releases.
Select your release from the list.
Select "Give this section a name" and enter a heading.
Select "Add your own text here..." and enter some body text.
Add other work related to your version
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:
From your project’s sidebar, select Releases and then select your version.
Select Add… in the Related work section.
Enter the URL for the related work, a description, or both.
Choose a category and select Save.
Once you’ve added related work, select the menu icon () next to an item and select 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.
From your project's sidebar, select Releases.
Select a release from the list.
In the Approvers section, select Add approver ().
Select an approver from the list of project members, and add an optional description to let them know what they are approving.
Was this helpful?
Still need help?
The Atlassian Community is here for you.