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.

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.

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, introduce los elementos de la lista con un caracter de espacio regular, seguido de [ ]. Para marcar una tarea como completada, utiliza [x].

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

Lista de tareas generada

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

Any issues that are referenced in a task list specify that they are tracked by the issue that contains the task list. To navigate to the tracking issue from the tracked issue, click on the tracking issue number in the Tracked in section next to the issue status.

Tracked in example

Further reading

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.