Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

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

What are the purposes of the fields attached in the details while creating a story in JIRA?

I was curious to know the purpose of some fields while creating issues. 

My assumption:

Summary field: This is where we write the user story in As a user..., want to..., so that..." format.

Description field: This is where we write the description for those user stories. This can include the workflow (positive, negative and alternate), overview of the story/module, validations, error messages etc.


If we have a plugin that provides separate fields for Acceptance criteria, then we can use it else the description field can also contain acceptance criteria. 


Is the above assumption correct? Also, what amount of detail is ideal to be included in the detail field? What is the optimal number of acceptance criteria foe a single user story?

JIRA issues.PNG

1 answer

0 votes

Hello @Suraj B

Thank you for reaching out.

The number of fields added to the issue detail view and how you'll use them to achieve your needs is completely subjective, and that's why you are free to remove or add fields to your issue view.

That being said, let me bring up more context and some examples on how other customers configured their detail view so we can better know we are on the same page:

1- There are some users that prefer to use separate fields to define acceptance criteria where you have more options to filter and search for fields with a specific value. For example: Supposing you would like to return a list in JQL with all the Stories where the "design" implementation was already implemented, it would be much easier to define a checkbox field with the "design" option instead of using the description field.

2 - However, there are other users that prefer to use the description field since they have simple scenarios where they will not need to filter specific achievements for the acceptance criteria.

In fact, you can choose to use the description field only as a source to display "Additional details" in the Detail view or define your Acceptance Criteria.

If you still have any questions about how you want to configure your views, I suggest you take a look at the documentation below:

8 steps to a definition of done in Jira 

Let me know if you have any specific questions about the information provided.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Jira Software

How to create Jira issus from Excel file?

When to use CSV importer When managing your processes in Jira, there are many occasions where you need to create a lot of tasks. Creating them one by one will cost you a lot of time and effort and i...

4,407 views 22 32
Read article

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