---
title: "List commands"
description: "Manage lists in Tiptap with Editor commands like liftListItem, sinkListItem, splitListItem, toggleList, and wrapInList."
canonical_url: "https://tiptap.dev/docs/editor/api/commands/lists"
---

# List commands

Manage lists in Tiptap with Editor commands like liftListItem, sinkListItem, splitListItem, toggleList, and wrapInList.

Lists are a crucial part of structuring content in your Tiptap editor. Tiptap provides commands to manipulate list structures easily. Here’s an overview of the essential commands that help you create, update, and manage your lists.

## Use Cases

- **Creating and Toggling Lists:** Create or switch between list types using [`toggleList`](https://tiptap.dev/docs/editor/api/commands/lists/toggle-list.md).
- **Nesting and Unnesting List Items:** Lift or sink list items using commands like [`liftListItem`](https://tiptap.dev/docs/editor/api/commands/lists/lift-list-item.md) and [`sinkListItem`](https://tiptap.dev/docs/editor/api/commands/lists/sink-list-item.md).
- **Splitting and Wrapping List Items:** Split or wrap list items efficiently with [`splitListItem`](https://tiptap.dev/docs/editor/api/commands/lists/split-list-item.md) and [`wrapInList`](https://tiptap.dev/docs/editor/api/commands/lists/wrap-in-list.md).
- **Improving List Keyboard Behavior:** Use the [`List Keymap`](https://tiptap.dev/docs/editor/extensions/functionality/listkeymap.md) extension to refine list behavior with additional keymap handlers.

## List Keymap Extension

You might also want to include the [`List Keymap`](https://tiptap.dev/docs/editor/extensions/functionality/listkeymap.md) extension, which adds extra keymap handlers to change the default backspace and delete behavior for lists. It modifies the default behavior so that pressing backspace at the start of a list item lifts the content into the list item above.

## Here’s a list of… list commands

| Command         | Description                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------- |
| `liftListItem`  | Attempts to lift the list item around the current selection up into a wrapping parent list. |
| `sinkListItem`  | Sinks the list item around the current selection down into a wrapping child list.           |
| `splitListItem` | Splits one list item into two separate list items.                                          |
| `toggleList`    | Toggles between different types of lists.                                                   |
| `wrapInList`    | Wraps a node in the current selection in a list.                                            |