Custom fields & acceptance criteria

[corinne.saebom]

Hi!

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,

Corinne

corinne.sabom@2wglobal.com

[Ste Wright]

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.

Ste

[Chandraprakash G]

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

[Aron Gombas _Midori_]

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: https://marketplace.atlassian.com/search?query=checklist

[Jack Hunter _HeroCoders_]

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.

Cheers,
Jack

[Pete Singleton]

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.