# @univerjs-pro/sheets-chart-thread-comment

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

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

- Requested language: `en-US`

- Content language: `en-US`

- Documentation version: `1.4.0`

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

---

Comment integration for chart objects returned by the Sheets chart Facade (`FSheetChart`). Configure [Sheets charts](https://docs.univer.ai/guides/sheets/features/charts.md) and register this plugin before opening a workbook.

```typescript
import { UniverSheetsChartThreadCommentPlugin } from '@univerjs-pro/sheets-chart-thread-comment'
import '@univerjs-pro/sheets-chart-thread-comment/facade'

univer.registerPlugin(UniverSheetsChartThreadCommentPlugin)

const chart = univerAPI.getActiveWorkbook()?.getActiveSheet()?.getCharts()[0]
await chart?.createCommentAsync('Verify the chart source.')
```

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 [Sheets comments guide](https://docs.univer.ai/guides/sheets/features/comments.md#object-comments).

## Facade methods

| Method | Behavior |
| --- | --- |
| `createCommentAsync(content, options?)` | Creates a comment anchored to the chart. 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. |

Import `@univerjs-pro/sheets-chart-thread-comment/facade` to register these methods on chart objects returned by `getCharts()` or `insertChart()`.