Skip to main content

About task lists

You can use task lists to break the work for an issue or pull request into smaller tasks, then track the full set of work to completion.

Note: For more information about the new iteration of Tasklists, which is currently in a private beta, see "About Tasklists."

About task lists

A task list is a set of tasks that each render on a separate line with a clickable checkbox. You can select or deselect the checkboxes to mark the tasks as complete or incomplete.

You can use Markdown to create a task list in any comment on GitHub Enterprise Cloud. If you reference an issue, pull request, or discussion in a task list, the reference will unfurl to show the title and state.

You can view task list summary information in issue and pull request lists, when the task list is in the initial comment.

Creating task lists

Para crear una lista de tareas, debe añadir como prefijo un guion y espacio, seguido de [ ] a los elementos de la lista. Para marcar una tarea como completada, use [x].

- [x] #739
- [ ] https://github.com/octo-org/octo-repo/issues/740
- [ ] Add delight to the experience when all tasks are complete :tada:

Lista de tareas generada

Tip: You cannot create task list items within closed issues or issues with linked pull requests.

Reordering tasks

You can reorder the items in a task list by clicking to the left of a task's checkbox, dragging the task to a new location, and dropping the task. You can reorder tasks across different lists in the same comment, but you can not reorder tasks across different comments.

Reordered task list

Further reading