Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Getting started

Subcomponents for Jira is an app that extends projects with the following component and version tools (extensions):


  • global settings

  • custom project permission 


  • convert project components into a meaningful hierarchy

  • select components from the hierarchy in issues including Service Desk Customer Portal

  • search issues and create reports based on subcomponents hierarchy with subcomponents() JQL

Documentation for Subcomponents extension


Component versions

  • plan and track releases on a component level

  • select versions in issues based on issue components

  • Jira Service Desk support

Documentation for Component versions extension



  • organize and track multiple versions as a single product release

  • find all packages where an issue is implemented using Packages issue panel

  • search issues and create reports based on packages with packageVersions() JQL

Documentation for Packages extension


Component properties

  • add more details to Jira project components using component properties (aka custom fields)

  • search issues and create reports based on component properties using componentProps() JQL

Documentation for Component properties extension


Version properties

  • add more details to Jira project versions using version properties (aka custom fields)

  • search issues and create reports based on version properties using versionProps() JQL

Documentation for Version properties extension

Global settings

  • Jira administrator can configure settings of each extension in the Settings section located in Jira administration / Manage apps / Subcomponents for Jira.

  • Each extension can be enabled/disabled on a project basis

  • Extension links can be enabled/disabled in project navigation and project settings sections.

Documentation for Global settings


Custom project permissions

Project administrator can grant permission to manage project Subcomponents, Packages, Component Versions to non-project admin users.

Documentation for Project permissions.



Every extension has a complete REST API documented with built-in Swagger UI available in your Jira administration → Manage apps → Subcomponents → REST API section.


How to install

  1. Log into your Jira instance as an admin.

  2. Click the admin dropdown and choose Atlassian Marketplace.

    The Manage apps screen loads.

  3. Click Find new apps from the left-hand side of the page.

  4. Locate Subcomponents for Jira via search.

    The appropriate app version appears in the search results.

  5. Click Free Trial to begin a new trial or Buy now to purchase a license for Subcomponents for Jira.

    You're prompted to log into MyAtlassian. Subcomponents for Jira begins to download.

  6. Enter your information and click Generate license when redirected to MyAtlassian.

  7. Click Apply license.

  8. If you're using an older version of UPM, you can copy and paste the license into your Jira instance.