# Quick Insert

- Human documentation: [https://docs.univer.ai/guides/docs/features/quick-insert](https://docs.univer.ai/guides/docs/features/quick-insert)

- Agent Markdown: [https://docs.univer.ai/guides/docs/features/quick-insert.md](https://docs.univer.ai/guides/docs/features/quick-insert.md)

- Requested language: `en-US`

- Content language: `en-US`

- Documentation version: `1.0.0-rc.0`

- Source: [docs/features/quick-insert.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/docs/features/quick-insert.mdx)

---

#### Package metadata

```json
{
  "plugins": [
    {
      "client": "@univerjs/docs-quick-insert-ui",
      "locale": "@univerjs/docs-quick-insert-ui/locale/en-US",
      "style": "@univerjs/docs-quick-insert-ui/lib/index.css"
    }
  ],
  "server": false
}
```

Quick Insert provides a slash-command style menu for inserting content. Type `/` at the start of an empty line to open the menu and quickly insert text, lists, dividers, tables, images, and more. This feature currently supports plugin mode only.

## Interactions

* Type `/` at the start of a line to open the menu
* A `+` button appears to the left of an empty paragraph; click it to open all available menus
* Type to filter; use ↑/↓ to navigate, Enter to insert, Esc to close

## Plugin Mode

### Installation

#### npm

```bash
npm install @univerjs/docs-quick-insert-ui
```

#### pnpm

```bash
pnpm add @univerjs/docs-quick-insert-ui
```

#### yarn

```bash
yarn add @univerjs/docs-quick-insert-ui
```

#### bun

```bash
bun add @univerjs/docs-quick-insert-ui
```

### Usage

```typescript
import { LocaleType, mergeLocales, Univer } from '@univerjs/core'
import { UniverDocsQuickInsertUIPlugin } from '@univerjs/docs-quick-insert-ui' // [!code ++]
import DocsQuickInsertUIEnUS from '@univerjs/docs-quick-insert-ui/locale/en-US' // [!code ++]

import '@univerjs/docs-quick-insert-ui/lib/index.css' // [!code ++]

const univer = new Univer({
  locale: LocaleType.EN_US,
  locales: {
    [LocaleType.EN_US]: mergeLocales(
      DocsQuickInsertUIEnUS, // [!code ++]
    ),
  },
})

univer.registerPlugin(UniverDocsQuickInsertUIPlugin) // [!code ++]
```