Article version:

About task lists

You can use task lists to create a list of items with checkboxes within pull request and issue comments or Markdown files in your repository.

Task lists render with clickable checkboxes in comments. You can select or unselect the checkboxes to mark them as complete or incomplete.

Task lists render as read-only checkboxes in Markdown files. People with write permissions in the repository can edit the file to select or unselect the checkboxes.


Task list summary

Creating task lists


- [x] Finish my changes
- [ ] Push my commits to GitHub
- [ ] Open a pull request

Rendered task list

Reordering tasks

You can reorder task lists within a single comment by clicking to the left of a task's checkbox, dragging it to a new location, and dropping it. If you have multiple lists within a comment, you can reorder tasks across the single comment. You can't add or reorder tasks across different comments.

Reordered task list

Further reading

Ask a human

Can't find what you're looking for?

Contact us