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

Custom fields & acceptance criteria



I really need help, tried to get a grip of Jira myself and have been looking through all documents and guides but it seems like I can't get a grip around the custom fields..

Me and my team would like to have multiple fields in the issues for user story, details and acceptance criteria

Today we are typing this manually in the description fields.... I'm sure there is a function for this i Jira right?

Also to be able to track & tick-off the actual acceptance criteria in the issues in order to make the DOD more transparent.. is this possible?


Please help me with this, we need to sort our Jira-side out and clean it up and make it more clear


Thank you in advance,


4 answers

Hi @corinne.saebom

You can create new custom fields to house Acceptance Criteria and similar - I'd suggest not splitting data too much as users still have to read it.

You've not mentioned a host type here, so I'm going to write general instructions for adding a custom field as an example:

  1. Go to Jira Admin Settings > Issues > Custom Fields
  2. Press "Add custom field" on this page
  3. Pick a relevant field type - for Acceptance Criteria, you probably want "Text Field (multi-line)". Now press Next.
  4. Give the field a name and press Create
  5. The next screen will offer to let you add the field to screens - choose relevant ones and press Update at the bottom of the page
  6. If you want to ensure the field is in the right position on your screen, go to Jira Admin Settings > Issues > Screens, locate the screens you added the field to and move the field to the right position.
  7. Finally, if you're using a multi-line field and want rich-text editing, go to Jira Admin Settings > Issues > Field Configurations and in each relevant configuration locate the new field. Click the hyperlink next to the field called "Renderers" and change it to "Wiki Style Render"

^ Basics of custom field creation. If you want a checklist view you'll need an app - such as Checklist for Jira or view more here.


@Stephen Wright _Elabor8_ Thanks a lot, step by step example was perfect to configure and make it work in one go!

0 votes

Your use case should be implemented by adding a new custom field with "checkable" items. This type of custom field is not available in core Jira, but there are several apps that provide these.

Try the apps found by this query:

0 votes

You can add a custom field of type free text or a list of predefined checkboxes (always the same) as explained by Steve and Pete. 

However, if you need a flexible list of checkboxes then only third-party plugins can do this. 

I can propose Issue Checklist Free developed by my team with a set of handy features like default checklist per project and issue type, blocking transition if acceptance criteria are not completed, etc.
There is also a paid version Issue Checklist Pro if you need to control permissions or if you need more tight integration with Jira Service Desk.


The main detail of the user story should be added to the Description field.  You could create a custom field named "Acceptance Criteria" which you could then add to the screens for your user stories.  This could either be a free text box, or a fixed list of checkboxes (if it's always going to be the same).  I would  imagine text would be better however.

As for tracking each of the acceptance criteria, you could create sub-tasks under the Story to achieve this.

Suggest an answer

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

Admins, notify your Jira instance of system-wide changes with the new admin announcement banner

Hi All! We’re excited to share the launch of an announcement banner that lets Jira site administrators communicate directly to their users across Jira Cloud instance.   📢 Get y...

135 views 6 6
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