Preparing a to-do list will help you ensure you complete everything that the work item entails on time. A checklist serves as a rudimentary item plan that you define right before you start work on an item.
Benefits of checklist
- Analyze the work item's progress effectively
- Ensure all aspects of the work item are covered
- Add multiple checklists
- Group similar sets of to-do-lists
- Complete or reopen them anytime
Use cases
1. Let's assume you are a marketing team and you are about to release a new webpage on your product website. Publishing a webpage comes with a few considerations that need to be handled. You can create a checklist for this item.
Checklist Name - Prerequisites for webpage release
- Update latest content in the backend content management tool
- Cross check with the UI team for design approval
- Check for CTAs (Call to actions)
- Link to social media sites
- SEO optimization
- Include blog, help center, support links to the website
- Upload videos and images to relevant feature descriptions
- Check whether the website work across browsers
- Include search bar
- Copy rights
- Publish
After all the prerequisites are fulfilled, you are ready to publish your webpage.
2. When a developer works on a new feature, they can create a Definition of Done checklist that will help them create a list of things to be completed before shipping the feature to the end-user.
Checklist group name - Client requirements
-
All code changes are implemented as per the approved requirements.
-
Code is clean, optimized, and adheres to coding standards.
-
No unnecessary console logs, commented code, or temporary files.
-
Database scripts (if any) are created, tested, and documented.
-
Code has been peer-reviewed and approved via pull/merge request.
-
All feedback from the code review has been addressed.
-
Code is merged into the correct branch (e.g., develop, staging).
-
Proper commit messages and versioning are used.
3. A customer has raised a feature request for a new checkout page for their website and has a few specific requirements within it. These requirements can be added as an Acceptance Criteria checklist in the work item. Only when every checklist is met can the work item be accepted as completed by the customer.
-
Prompt users to login if they aren't logged in already
-
Include multiple payment options - Credit/ Debit card, Netbanking, Cash on delivery
-
Slow previously saved payment options
-
Show offers and discounts across different payment options
-
Allow users to apply coupons or promo codes
-
Display the cart items
-
Option to move the cart items to wish-list
-
Option to delete the cart items permanently from the cart
Create Checklist Template and use them within work items if you are reusing the similar checklist for similar type of work items. Know more about
Checklist Template.
Difference between checklists and subitems
Subitems are secondary entities that are treated as work items. They require time and effort on their own. However, a checklist is just a to-do list that you use to build the work item at hand. It's not treated as an individual work item that you require to complete in order to move the parent item to a closed status.
Checklist Group
Create checklist group and add the checklists within them to spot your checklists easily and work on accomplishing them. For instance, when a new feature is added as a work item, UI team works on designing the layout, UE team provides content to be added to UI, Developer works on the code, Quality team checks for any issues. Each team will have their own checklists. Therefore, checklist should be grouped based on the scope of work.
Create Checklist Group
- Go to the item details page of the work item.
- Go to the Checklist tab.
- Click the +Group button. The Add Checklist Group window will appear.
- Enter the Checklist Group Name under which the checklist will be added.
- Enter Checklist Name which is the prerequisite you need fulfilled.
- Assign users.
- Make the checklist public for your team or keep it private for your reference.
- Assign priority.
- Click the Create button. The checklist is created.
Add checklist to a checklist group
- Go to the item details page of the work item.
- Go to the Checklist tab.
- Click + More Checklist under a Checklist Group.
- Alternatively, click the dropdown arrow beside +Group and select Checklist.
- Enter the checklist details such as Name, Access, Assign to, Priority.
- Click the tick mark.
Create dynamic checklist using placeholders
Customize the checklist for the work item by including placeholders which will dynamically change for each item. This provides more context to the checklist.
For example, an item is considered complete only when the following actions are performed in the work item:
- Sprint owner should cross check if the item's assignee has added item points to the work item before starting the work item.
- Item assignee should verify the DB values.
- When an item gets updated, the item creator should be informed about it.
- Item should be completed before the scheduled end date.
All this information can be added within the work item's checklist and each checklist can have a placeholder which will dynamically change for every work item.
Refer to the screenshot attached below for better understanding:
Reorder Checklist Group
Reorder the checklist group to view them based on your need.
- Go to the item details page of the work item.
- Go to the Checklist tab.
- Click the dropdown arrow beside +Group and select Reorder Group.
Checklist groups will be listed in the existing order.
- Drag and drop the group name in the required sequence.
- Click Save.
View Checklist by Type
You can choose to view only the checklist of a particular type from within the Checklist section of the work item.
- Go to the item details page of the work item.
- Go to the Checklist tab.
- Beside the Checklist header, click on the respective checklist type.
This view will list only the checklist belonging to that checklist type.
Convert Checklist to Template
Checklist group can be converted as a template anytime from within the Checklist module in a work item.
- Go to the item details page of the work item.
- Go to the Checklist tab.
- Under each checklist group, you'll find a 'Convert to Template' button.
- Click Convert to Template. Make required changes in the create checklist template form.
- Click Create.
Note: When you convert the checklist group to a template, the private checklists will become public.
Reorder checklist
To reorder checklist items in a group:
- Go to the item details page of the work item.
- Go to the Checklist tab.
- Click the Reorder button.
- Drag and drop the checklist items to change the order. Or, modify the sequence numbers.
- Click Save. The checklist will be reordered.
Delete checklist group
To delete checklist group:
- Go to the item details page of the work item.
- Go to the Checklist tab.
- Hover over the required checklist group name.
- Click the Delete link. A confirmation pop-up will appear.
- Confirm your action.
- Click the Delete button. The checklist group will be removed.
Delete checklist
To delete checklist in a group:
- Go to the item details page of the work item.
- Go to the Checklist tab.
- Hover over the required checklist name.
- Click the Delete link. A confirmation pop-up will appear.
- Confirm your action.
- Click the Delete button. The checklist will be removed.
To delete checklist group, hover over the group and click the Delete link.
Complete checklist
To complete a checklist item:
- Go to the Checklist tab.
- Select the checkbox inline with the checklist. The checklist is completed and is denoted by it being struck out.
Deselect the checkbox to reopen the checklist.Make an item
You can turn a checklist into a work item if it requires that kind of time and effort.
To make an item:
- Go to the item details page of the work item.
- Go to the Checklist tab.
- Hover over the required checklist.
- Click the Make it an item link. The Create Item window will appear.
- Enter required details and click the Create button. The checklist item is also added as a work item.