# @univerjs-pro/docs-drawing-thread-comment

- Human documentation: [https://docs.univer.ai/reference/packages/plugins/univerjs-pro/docs-drawing-thread-comment](https://docs.univer.ai/reference/packages/plugins/univerjs-pro/docs-drawing-thread-comment)

- Agent Markdown: [https://docs.univer.ai/reference/packages/plugins/univerjs-pro/docs-drawing-thread-comment.md](https://docs.univer.ai/reference/packages/plugins/univerjs-pro/docs-drawing-thread-comment.md)

- Requested language: `en-US`

- Content language: `en-US`

- Documentation version: `1.4.0`

- Source: [packages/plugins/univerjs-pro/docs-drawing-thread-comment.mdx](https://github.com/dream-num/documentation/blob/dev/content/reference/packages/plugins/univerjs-pro/docs-drawing-thread-comment.mdx)

---

Comment integration for document images (`FDocumentImage`). Configure [Docs images](https://docs.univer.ai/guides/docs/features/images.md) and register this plugin before opening a document.

```typescript
import { UniverDocsDrawingThreadCommentPlugin } from '@univerjs-pro/docs-drawing-thread-comment'
import '@univerjs-pro/docs-drawing-thread-comment/facade'

univer.registerPlugin(UniverDocsDrawingThreadCommentPlugin)

const image = univerAPI.getActiveDocument()?.getImages()[0]
await image?.createCommentAsync('Add alternative text.')
```

The plugin supplies its shared Shape/thread-comment dependencies. It has no configuration options, locales, or styles of its own. Configure comment UI and persistence through the [Docs comments guide](https://docs.univer.ai/guides/docs/features/comments.md#object-comments).

## Facade methods

| Method | Behavior |
| --- | --- |
| `createCommentAsync(content, options?)` | Creates a comment anchored to the image. Accepts plain text or a document body and optional IDs, author, attachments, and creation time. Resolves to command success; empty content throws `TypeError`. |
| `getComments()` | Returns locally loaded matching comment threads. |
| `listCommentsAsync()` | Synchronizes known threads, then returns matching comments. |

See the [image Facade reference](https://docs.univer.ai/reference/facade/document-image.md#createcommentasync) for signatures. Import `@univerjs-pro/docs-drawing-thread-comment/facade` to register these methods.