> ## Documentation Index
> Fetch the complete documentation index at: https://developers.myhero.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Add comment

> Comment on a passage of a HERO document, as the user: it appears in the comment panel under their name, highlighted on the passage. Quote the passage in…

`add_comment`

Comment on a passage of a HERO document, as the user: it appears in the comment panel under their name, highlighted on the passage. Quote the passage in `passage` exactly as the document has it (within one block). When it appears in more than one block, also pass that block's blockId (list\_document\_blocks); a blockId alone comments on the whole block. For a Word file use docx\_comment.

## Parameters

**documentId** `string` *required*

The HERO document.

**passage** `string`

The text to comment on, quoted from the document.

**blockId** `string`

The block the passage is in, or the block to comment on.

**comment** `string` *required*

What the comment says.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.