How Are Issues Handled in JIRA? – Atlassian JIRA Tutorial #2

Working with JIRA Issues

JIRA – we are now in the midst of self-learning this tool. In the last JIRA tutorial, we talked about the underlying JIRA process – the Incident Management and a few high-level details of the tool itself.

Today we are going to move on to yet another interesting topic – How are the issues handled in JIRA?

Before we get into more details let us now reiterate what an issue is:

An issue is anything that you would track to completion. Some examples specific to QA can be – a document to be created, a document to be reviewed, a bug or an environmental issue.

Now let’s move on to creating an issue, assuming that the user logged in is not an admin and our test project is “Test for STH” with components – Module 1 and Module 2, versions – version 1 and Version 2. Key – TFS is already created.

Issues handled in JIRA

Creating a JIRA Issue

Issues form the crux of JIRA, so in order to create them there is an option right on the menu bar:

Creating a JIRA issue 1

Click on “Create Issue” button. Alternately, when you type “c” while on the JIRA page, the following ‘Create Issue’ dialogue opens up.

Creating issues in JIRA 2

All the fields in this page are self-explanatory. We will discuss the most important one below.

Project: Every issue belongs to a project. You can choose the same by clicking on the drop down and choosing the project to which you want this issue to belong to.

Creating issues in JIRA 3

Issue type:  This field displays all the types of issues that can be created and tracked via JIRA. The following options are available on this list (this list might differ depending upon the setting set by the administrator):

Creating issues in JIRA 4

The items Bug, new feature, task, improvement are exactly what their names imply. Epic and story are more relevant to the agile projects. A Story is a requirement in Agile that needs to be tracked from the start to finish. An Epic is a group of stories.

Choose the issue type as needed. I am going to go with “Bug”.

Summary: Give your bug a title here.  When used right, this field can be very successful at transmitting a lot of critical information. Some aspects to note here:

A bug/defect is essentially something that is not right. The right way to approach a bug title is to concisely define ‘what’s wrong’.

An example of a bad title/summary is “There should be an option to clear the contents on the screen”.  When I read this my initial reaction is going to be – “Okay, there should be- but what’s the problem here? Is the option not present at all? Or is the options present and not clearing the content?”

It is also agreed, that when I open this bug and look into it in detail, I am sure I will find the answer to this question.

However, the emphasis here is to use this “Summary” field in the most efficient manner. Therefore, a very apt summary/title would be “The option to clear the contents of the home login page does not clear the fields when clicked.”

In the limited space that this field provides try to write your title in a way that communicates the exact issue without any ambiguity.

Priority:  This field can take one of the following values.

Choose an appropriate option for your bug.

Creating issues in JIRA 5

Component: This list will display the components of the Project. Choose appropriately.

Affected Version and Fix version: These two fields will display the versions available for the project. It is not necessary that a certain issue that you encountered in a certain version gets fixed in the same one. In cases like that, you can choose the affected version as the current version and the fix version as the next one.

Also, these fields can take multiple values. You can choose to set that a certain issue affects both version 1 and version 2 as below:

Creating issues in JIRA 6

Assignee: You can type the name of the person to whom this issue should be handed over further. You can also assign an issue to yourself.

Creating issues in JIRA 7

Description: This is an optional text field that aids you to enter as much information as you would like about your issue. In case of a bug, it is typical to use this field to give in a detailed information about the steps to reproduce the defect.
It is of utmost importance to give all the information.

“Say, there are two fields – dependent ones- State and City. When I choose State from the drop down, in the City field it should display the respective cities in the state I chose.

If I raised a bug as “The cities are empty for some states I selected”. The description field it the place for me to elaborate on this defect.

An example for an insufficient description is:

1) Enter the site
2) Click on the address page
3) Enter the other details like name, street address etc.
4) Click on the ” State” drop-down. Choose a state
5) Click on the “City” drop-down – note the city names

The above description though precise, it is not complete. When it comes to this field, is on the side of providing too much information but not too little.

If the following steps are added to the description, then this will make more sense.

6) Choose the state as “California” and click on the “City” drop down – all the states will be displayed and the user can select a city as needed.
7) Choose the state as “Louisiana” and click on the “City” drop down – the list will be empty.
8) The cities are empty for the states New Jersey and Utah also.

So, to repeat, provide the exact steps, the exact data and any other information you think that is necessary to complete this field.

Attachment:  Any supporting document can be uploaded with an issue.

Once all the information is entered to your satisfaction, the issue can be created by clicking on the “Create” button at the end of the “Create Issue” dialogue.

The issue gets created and a message is displayed to the user with the issue ID:

Creating issues in JIRA 8

Note: notice the issue ID; it is prefixed by the “Key” of the project. It is JIRA’s way of tracking/grouping the issues that belong to a certain project.

You can now view the created issue, by clicking on the link that appears in the above message.

Additional Details About the Create Issue Page

1) There will be a configure fields option found on the top-right corner of the “Create Issue” page.

Creating issues in JIRA 9

This option can be used to choose/alter the fields that you would like to see in your create issue dialogue. Once a choice is made, JIRA will remember the changes for your subsequent issues too.

2) At the bottom of the “Create Issue” page, there is a “create another”

Creating issues in JIRA 10

When you choose this option and click “Create”- once, the current issue is created; JIRA keeps the
“Create Issue” dialogue open with Project, Issue type and other fields except summary auto selected as per the previous issues created.


With that, we conclude the topic “Creating an issue in JIRA”.

In the next Atlassian JIRA tutorial, we will learn about sub-tasks and how to use them for specific QA purposes.

Stay tuned and do let us know your comments, questions, and suggestions below.

28 Comments on “How Are Issues Handled in JIRA? – Atlassian JIRA Tutorial #2

  1. Very informative Sir, thanks alot.

  2. thanks for explaining the process. Along with this I got some nice tips on logging a defect report as well.

  3. Hi, I recently switch to new company where they are using JIRA to log Bug, these article will be great help in learning.

  4. Thanks for explaining the Issues Handled in JIRA.

  5. Generally I used jira for knowing the Defect status and some time I need to do Retest based on ALM status. We will raise a defect on ALM. Onshore people will test the defect once again if they reproducible it, They will move the bug to Jira.

    Ex: Test1 xxxxxxxxxxxxx – Moved to Jira(xxxxxxx). At the End of sprint we people retested it on different environments. I don’t know how they will move the defect to Jira. After Reading your article I understood.

  6. Nice explanation, We are using our own bug tracking tool but i found concept is taken from Jira.

  7. People easily can under stand about jira after reading all tutorials(6) which are published on this site. Thanks a lot.

  8. If possible please provide tutorial on Janova.

  9. Thanks for Article about JIRA, its very helpful for me I am beginner in testing from different background of field, currently I have start learning JIRA and I found problem in my trial version its showing only 2 option in ISSUE TYPE which are New Feature and Task other options are not showing its bcz of trail version or something else?

    Thanks again for this article and all other blogs…….

  10. @Dee: it is because of the type of project you have created. Try to create a project of the type software development and you will see the other issue types too….

  11. @Naveen: thank you for your request for Janova…we will surely keep it in mind.

  12. Thank you Swati………

  13. Hi, very helpfull article thank you very much. I recently joint the company and they use JIRA. They attach the file after the issue is created. I realized that the file can be attached while creating the issue. I test but I couldnt find the attachment checkbox in Configure files drop down menu. My question is: How can we add the attachment checkbox in it? Thanks in advance

  14. how the developer is gng to report the issus to project manager using this jira

  15. Very nice.

  16. Its very nice,use for handling defect

  17. I went through all 6 tutorials and side by side exploring/learning JIRA UI as well and I must say that these tutorials covered each and every aspect of learning JIRA for a new user and in very detailed and elaborative mode with mapped screenshots.

  18. While reading this document i experimented the same on Jira. very useful document for the beginners.

    Thanks for providing such a useful information!!

  19. Nice one,, very easy to understand, Like the shortcut you provided ‘c’ to open the create ticket option

  20. If possible please provide the basic document for JIRA

  21. If possible provide some insight on how JIRA and Confluence work with each other. Thanks!

  22. usefull for us…
    Thaks so much..

  23. Useful , Thanks.

  24. you did not mention URL or Browser when creating an issue ?

  25. 1. Can I add options to “Issue Type” to suit our needs? Or, are they a canned set, from JIRA?
    2. Can I add options to “Priority” to suit our needs? Or, are they a canned set, from JIRA?
    3. Can we re-name the fields? Maybe we don’t want to name the field “Components”, can this or any other field be re-named?
    a. If a field can be re-named, will the new name present problems in other areas of JIRA, such as report generation?
    i. Does/would the old name still be utilized?
    4. Can we add fields to the ‘Issues’ form?
    5. Can we remove fields from the ‘Issues’ form?
    6. Can we add any type of validation checking to the ‘Issues’ form?
    a. I want to make sure that certain fields are populated.
    7. Can I install JIRA on my own server, and not over the internet?

  26. I t is Very Helpfull….Thank you.

  27. wow,awesome information
    Thank you so much

Leave a Comment