What is a Jira issue and a Jira project? Why are users often confused by these terms? Why are things named the way they are?
Jira terminology is strange at first and even foreign if you’re using Jira to track business processes. Jira began as a bug tracking tool for software development teams and morphed into an issue tracker and project management tool for all teams. Some of the naming reflects its origins and the need for somewhat generic terminology so it can support #allthethings. Further, your organization may have introduced additional custom naming or language translations, which can add to the confusion.
Here are three fundamental Jira terminology concepts to understand:
Issue – an individual item in Jira
Why the confusion? The dictionary defines “issue” as “an important topic or problem for debate or discussion”. In Jira however, an “issue” represents all types of requests including: things to do, tasks, bugs and defects, new features, improvements, changes, incidents, tickets, problems, etc. An issue is a single unique record of any type, regardless of its content or the scenario. Requests like “I need a new desk phone” is an issue just like “Create a new product” and “The server is down!” are issues. Each Jira issue has a unique key in the format: KEY-123.
Project – a collection of Jira issues
Why the confusion? Teams have their own internal initiatives or strategic priorities they often call “projects.” Yet in Jira, a collection of issues is also called a project! For example, the Marketing team’s many internal projects are tracked in their one Jira project. Think of a Jira project is a bucket that contains a “to do” list. Projects are often set up per department, per team, or to track large initiatives with a known end date.
Issue Type – a classification of issues in a Jira project
Why the confusion? Each Jira issue can be of a different type. For example, you may use a “Bug” type to report a defect and a “Feature” type to request new functionality. Each Jira project can have its own set of available issue types. A development project may have issue types like: Feature and Bug and a Legal project may have issue types like: Task and Sub-task. Different issue types allow for different fields, different workflows, or both, within the same Jira project.
Not sure which issue type to select? Just make your best guess. An issue can easily be changed later using Jira’s “Move” command.
Regardless of the wording, you can use Jira to: schedule and record work, manage your project pipeline, report and fix bugs, triage issues, report time and monitor progress, track changes and tasks, and keep a authoritative, historical, and legal record of work.
Rachel WrightCommunity Leader
Connect with like-minded Atlassian users at free events near you!Find an event
Connect with like-minded Atlassian users at free events near you!
Unfortunately there are no Community Events near you at the moment.Host an event
You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events