---
title: "ListItem extension"
description: "Use the List Item extension in Tiptap to add support for the `` tag used in bullet and ordered lists. Learn more in our docs!"
canonical_url: "https://tiptap.dev/docs/editor/extensions/nodes/list-item"
---

# ListItem extension

Use the List Item extension in Tiptap to add support for the `` tag used in bullet and ordered lists. Learn more in our docs!

The ListItem extension adds support for the `<li>` HTML tag. It’s used for bullet lists and ordered lists and can’t really be used without them.

> **Interactive demo:** [ListItem](https://embed.tiptap.dev/preview/Nodes/ListItem)

> **Modify backspace behavior:**
>
> If you want to modify the standard behavior of backspace and delete functions for lists, you
> should read about the [ListKeymap](https://tiptap.dev/docs/editor/extensions/functionality/listkeymap.md) extension.

## Install

```bash
npm install @tiptap/extension-list
```

This extension requires the [`BulletList`](https://tiptap.dev/docs/editor/extensions/nodes/bullet-list.md) or [`OrderedList`](https://tiptap.dev/docs/editor/extensions/nodes/ordered-list.md) node.

## Usage

```js
import { Editor } from '@tiptap/core'
import { ListItem } from '@tiptap/extension-list'

new Editor({
  extensions: [ListItem],
})
```

This extension is installed by default with the `ListKit` extension, so you don’t need to install it separately.

```ts
import { Editor } from '@tiptap/core'
import { ListKit } from '@tiptap/extension-list'

new Editor({
  extensions: [ListKit],
})
```

## Settings

### HTMLAttributes

Custom HTML attributes that should be added to the rendered HTML tag.

```js
ListItem.configure({
  HTMLAttributes: {
    class: 'my-custom-class',
  },
})
```

## Keyboard shortcuts

| Command         | Windows/Linux | macOS       |
| --------------- | ------------- | ----------- |
| splitListItem() | Enter         | Enter       |
| sinkListItem()  | Tab           | Tab         |
| liftListItem()  | Shift + Tab   | Shift + Tab |

## Source code

[packages/extension-list/src/item/](https://github.com/ueberdosis/tiptap/blob/main/packages/extension-list/src/item/)

## Minimal Install

```js
import { Editor } from '@tiptap/core'
import { ListItem } from '@tiptap/extension-list/item'

new Editor({
  extensions: [ListItem],
})
```