---
title: "Lists"
description: "List extensions add bullet lists, numbered lists, and task lists with checkboxes to the editor."
canonical_url: "https://tiptap.dev/docs/editor/extensions/lists"
---

# Lists

List extensions add bullet lists, numbered lists, and task lists with checkboxes to the editor.

## When you use them

- **Bullet points.** Bullet list adds unordered lists, rendered as `ul` tags.
- **Numbered steps.** Ordered list adds numbered lists, rendered as `ol` tags.
- **To-dos.** Task list and Task item add tasks, each with a checkbox that people check off.
- **Editing lists.** List keymap changes backspace at the start of a list item, so it lifts the content into the list item above.

## How they work

- **A list is two nodes.** Bullet list and Ordered list hold List items, and Task list holds Task items. Each list needs its item node. [Nodes and marks](https://tiptap.dev/docs/editor/core-concepts/nodes-and-marks.md)
- **The List kit bundles them.** The [List kit](https://tiptap.dev/docs/editor/extensions/functionality/list-kit.md) holds Bullet list, List item, Ordered list, Task item, Task list, and List keymap.
- **The StarterKit has the basics.** Bullet list, List item, Ordered list, and List keymap are part of the [StarterKit](https://tiptap.dev/docs/editor/extensions/functionality/starterkit.md); Task list and Task item are not.
- **Shortcuts.** Typing `- ` at the start of a line starts a bullet list, `1. ` an ordered list, and `[ ] ` a task list. Tab nests a list item and Shift + Tab lifts it out. [Keyboard shortcuts](https://tiptap.dev/docs/editor/core-concepts/keyboard-shortcuts.md)

## Related

- [Text blocks](https://tiptap.dev/docs/editor/extensions/text-blocks.md) are the paragraphs, headings, and quotes around your lists.
- [Tables](https://tiptap.dev/docs/editor/extensions/tables.md) put content in rows and columns.