It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Common Jira Terms and Concepts

Question

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?

Answer

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.

2 comments

Nice article @Rachel Wright, thanks.

 

I think the most common terminology difference that we face is the term "project". For PMO project can be a bunch of issues which costs more than some specific man/hour calculation, and it has start/end dates. Unlikely, Jira's projects may live forever without an end date, they have versions instead.

Anyway, great article.

nice.jpeg

issues are projects with no urgent end date. A to do list of many issues. A single issue can be immediate and urgent.

Comment

Log in or Sign up to comment
TAGS

Community Events

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

Events near you