Skip to content



Releases in Jira are set up to mirror the corresponding git Release branches

Releases exist to group related tasks and issues into a bundle that will be deployed as a whole. They're also called Versions in some parts of Jira.

When to create Releases

Releases are useful when there's a large backlog of tasks and you want to group them into versions that can be released in isolation from each other.

Remember to group dependencies together, and keep in mind that Releases must go live as a whole, so don't bundle a long running task with smaller, more important tasks.

Managing Releases in Jira

Turning on Releases

  1. Navigate to your Project
  2. Click the "Project Administration" cog in the bottom of the left sidebar
  3. Click Versions

Once a Version is created you'll see a Releases icon in the left sidebar of your project (it's a ship. Because shipping, or something).

Creating and editing Releases

Once you've started using Releases (see above):

  1. Navigate to your Project
  2. Click Releases in the left sidebar
  3. Click Manage Versions in the top-right corner
  4. Enter values into the topmost row and click Add. All but the name are optional and can be edited later.

Assigning tickets to Releases

  1. Navigate to a ticket
  2. In the top area, edit the "Fix Version(s)" field and choose a Release

Releasing a Release

Once you've deployed a Release to live

  1. Navigate to your Project
  2. Click Releases in the left sidebar
  3. Click the name of your Release
  4. Click the Release button in the top-right corner
  5. Add a date if necessary and click Release