JIRA is now available as three separate applications, JIRA Software, JIRA Service Desk, and JIRA Core. For more information on administering these applications, refer to the Administering JIRA Applications documentation.

Defining a Component

Components are sub-sections of a project. They are used to group issues within a project into smaller parts.

Note that you can set a Default Assignee for a component. This will override the project's default assignee, for issues in that component.

On this page:

Managing a project's components

  1. Log in to JIRA as a project administrator.
  2. Choose > Projects, and click the name of a project. The Project Summary page is displayed (see Defining a Project).
    (tick) Keyboard shortcut: g + g + start typing project
  3. Choose Components in the left menu. The Components page is displayed, showing a list of components and each component's details. From here you can manage the project's components as described below.

    Screenshot: The 'Components' screen

Adding a new component

  1. The Add Component form is located at the top of the 'Components' screen.
  2. Enter the Name for the component. Optionally enter a Description and select a Component Lead and Default Assignee (see options below).

Selecting a Default Assignee

You can optionally set a Default Assignee for a component. This will override the project's default assignee, for issues in that component.
(info) If an issue has multiple components, and the default assignees of components clash, the assignee will be set to the default assignee of the component that is first alphabetically.

Default Assignee Option



Project Default

Issues matching this component will have the assignee set to the same default assignee as the parent project.

Project Lead

The assignee will be set to the project leader.

If the project leader is not permitted to be assigned to issues in the permission scheme this option will be disabled and will say "Project Lead is not allowed to be assigned issues".

Component Lead

The assignee will be set to the component leader.

If the component leader is not permitted to be assigned to issues in the permission scheme this option will be disabled and will say "Component Lead is not allowed to be assigned issues". The Component Lead option will also not be available if the component does not have a lead assigned to the component. Instead under this option it will say "Component does not have a lead.".


The assignee of the issue will not be set on the creation of this issue.

This option will only be available if "Allow unassigned issues" is enabled in the General Configuration.

Editing a component's details

  1. On the 'Components' screen, hover over the relevant component to display the pencil icon.
  2. Edit the component's Name, Description, Lead and Default Assignee.
  3. Click the Update button to save your changes.

Deleting a component

  1. On the 'Components' screen, hover over the relevant component to display the Delete button.
  2. You will be prompted to associate these issues with another component if you wish.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

45 Archived comments

  1. User avatar


    is there a way to maintain the compontet with a language dependent name?

    03 Mar 2011
  2. User avatar


    I would really like to be able to version components in the same manner you may version projects.  It would solve many issues for the way we use Jira.  For us, a component is often a piece of hardware or software included in our system project which may change/version throughout the project.  Being able to version the components and record affected component version/s in issues would be a great help.  Adding the same release mechanism to the component would also be helpful.  It would essentially make the component a sub-project but without all the rest of the project details.

    09 Mar 2011
    1. User avatar


      I´m just looking for the same thing. Cannot find anything in the plugins archive. Would be a killer feature!

      I need it for projects where the components are

      - Backend

      - Android App

      - iPhone App

      Would be just perfect to define versions per component, because they have different release cycles. Splitting up the project in multiple projects does not make too much sense.

      20 Jun 2011
    1. User avatar

      Bjorn Andersson

      Component versioning would be a killer addition to the product.  For us, components are often vendor software included in our system projects and not being able to version these components is a major headache.

      03 Aug 2011
    1. User avatar


      +1 to this request. At this point I need independent versioning so badly that I think I'm just going to create one project per component, but the systems are tightly-coupled and as such many issues need to be attached to more than one system. An alternative approach that might be even better is to allow projects to be added as sub-projects of an overarching project, so that issues may be created for one sub-project or for the project as a whole depending on their scope.

      27 Aug 2012
      1. User avatar

        Till Affolter

        Agreed. In our environment JIRA projects should represent software solutions which consist of several components. A solution is just an umbrella but requires a version number independent from its components. Being able to give components version numbers too is crucial for us otherwise we'll have to track each component in a separate JIRA project.

        05 Sep 2012
        1. User avatar


          +1. We really really really really need this.

          09 Apr 2013
          1. User avatar


            Can Atlassian take this up please? It would be really good to group components or tag them.

            25 Mar 2014
    1. User avatar


      Heck Freakin' Yeah!!!! This would be a super sweet feature!!!

      26 Mar 2013
  3. User avatar


    Is there a way of specifying a main Component Lead and his backups?

    11 Mar 2011
  4. User avatar


    Hi All, I'm new on JIRA and testing the possibilities.

    Is there a way to use the same component in 2 different projects ?

    13 Apr 2011
    1. User avatar


      Yes, I believe it is called "Cut and Paste" lol.   But if someone has a better answer, please weigh in!

      27 Apr 2011
    1. User avatar


      No components are project specific and so if you use the name for example User Interface for one project and want to use it for another you can't. As well component names are case insentive meaning just trying to change capitalization (i.e. Component to comPonenT or User Interface to user interface) wont work they are recognized as the same thing in Jira. The better idea is to take some part of the project name and add a dash and then use the component name you wish (i.e. Project 1 - User Interface etc...)

      11 Jun 2012
  5. User avatar


    Will it be possible to track (Burdown) issue completion within a component ?

    07 Nov 2011
  6. User avatar


    How can I make it so that you can create components from an issue? I don't want only admins to be able to create components.

    25 Nov 2011
  7. User avatar


    If i have a issue associated with two components, by default, who the issue will be assigned? The owner of the first component selected? The project lead? Random?

    12 Dec 2011
  8. User avatar


    is there any way to create a component for more than a project at the same time?


    09 Jan 2012
  9. User avatar


    how does i managed to set up  one component to point to my repoA and another componenet to point to repoB


    21 Feb 2012
  10. User avatar


    If I add components to an already existing project will it restructure the project?

    08 Mar 2012
  11. User avatar

    greg elofson

    As with much of the current documentation relating to OnDemand, the initial instructions don't seem to account for whether or not the "Issues" tab needs to be clicked after choosing "Administration":

    1. Click the 'Administration' link at the top of the screen.
    2. Click 'Projects' and select the project of interest.

    Thus, one needs to click "Issues" after "Administration" to navigate to the indicated screenshots 1 and 2.  Else, one is presented with a set of projects immediately after clicking "Administration," which after selecting a project from that screen will not take you to the project screen with components.

    06 Apr 2012
  12. User avatar


    It seems that a lot of folks are asking questions but no one is doing any "answering".....

    09 Apr 2012
  13. User avatar


    I am trying to set up components in the ondemand version of Jira and it does not seem to allow me to do that. Compnents appear as a field when you create an issue, but it is not editable, and when you go to the project summary view, it does not include the components section as described above. Am I doing something wrong?


    26 Apr 2012
    1. User avatar


      Ditto.  The documentation indicates that there should be a 'more' on the bottom right of the summary screen, but there is none.  The summary screen for the project only contains Description, Issues: 30 day Summary, and an Activity Stream

      How do I get components to display?

      21 May 2012
  14. User avatar



    Is there a way to disable a component from the component list in an issue ?

    Because it can happen that some components are transient, and if I remove it, all issues with this component will be changed (and I don't want).


    Thank you

    26 Jul 2012
  15. User avatar


    There description above does not take you to the right project summary page... what you actually need to do is:

    Administration -> Projects -> (your project) -> Issues -> Projects -> (your project)

    yes, it should exist here ------------^^^^^ in its entirety, but doesnt....

    20 Aug 2012
  16. User avatar


    How does one display the component?

    I created a few components; but no field shows up for components when entering the defect.

    I am using the online version of JIRA and working for a verry large French firm with DS as initials; JIRA managers please pay heed.

    23 Aug 2012
    1. User avatar


      I have this same problem. Please help!

      27 Dec 2012
    1. User avatar


      This might already have been resolved, you need to be sure to add the components field to the screen. An easy way to see what's going wrong is when you create a ticket, click on the "Configure Field" button then on "Where's my field?" type in the field you are looking for and it will tell you what's working, what isn't, and where you need to go to fix the problem.

      26 Jul 2013
  17. User avatar


    Is there anyway to add an icon representation for a component?

    06 Sep 2012
  18. User avatar


    Not sure if this is answered somewhere above, but is there a way to get rid of the "No Component" component in Jira? Thanks.

    06 Sep 2012
  19. User avatar


    Whenever I tried to update components it keeps loading but no message or what so ever to indicate error 

    15 Oct 2012
  20. User avatar


    Is there a way to limit component selection to just one component while logging/editing issues? Thanks.

    16 Jan 2013
  21. User avatar


    If you select more than one component and each one has a default assignee, who gets assigned the issue?



    13 Mar 2013
    1. User avatar


      I beleive it takes the first component alphabetically and uses that assignee.

      26 Apr 2013
  22. User avatar

    joon joon



    09 Apr 2013
  23. User avatar


    Software Developers Develop Software Components, so why cant developers add components to jira, why does it have to be a project administrator, and most baffling, why can't i change this permission? 

    Just over complicated, too many rules. yuck!

    05 Jul 2013
  24. User avatar


    Is there a way to make a group as a lead of the component? The idea would be to receive notifications only for specific component.

    05 Aug 2013
  25. User avatar

    James Judge

    I'm trying to use components in a project almost as sub-versions of a product.

    Is there any way to move components (and all the issues within the component) from one project to another?

    09 Aug 2013
  26. User avatar


    What this person said! Trying to do the same thing.


    Is there a way to make a group as a lead of the component? The idea would be to receive notifications only for specific component.

    22 Aug 2013
  27. User avatar


    is there a way to set some security permissions for each component ? so not each group could only see some specific issues related to that component ?

    11 Dec 2013
  28. User avatar


    To manage modular designs and reuse

    A means to handle composition of components would be essential.

    As would enabling a component to be used in multipl projects.


    18 Dec 2013
  29. User avatar


    can this software; atlassian JIRA on demand be used to track staff daily work activity? 

    27 Mar 2014
  30. User avatar

    Jeff MacDonald

    Is there a way, using the JIRA Advanced email handler that a new issue created via email can be assigned to a component ? Either dynamically by inluding something in the email, or by default so that all issues via email belong to a certain component?

    22 Aug 2014
  31. User avatar

    James Barwick

    Is there a way to add an issue in all of the projects that match the component list?


    issue on project A, component "c1, c2, c3"

    On transition of issue from 'triage' to 'verified', create issue on project c1, project c2, project c3

    If the project doesn't exist, simply ignore that single component.


    23 Aug 2014
  32. User avatar

    Delany Middleton

    How close to this is JIRA?

    07 Nov 2014
Powered by Confluence and Scroll Viewport