> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open-artifacts.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Comment on a page

> Leave a note on a whole page, on a quote, or on a spot in an image or PDF. Reply, resolve, and control comment emails.

People who can open a page can comment on it, unless comments are limited or turned off.

## Add a comment

Open the page and click **Comments** in the top bar to see the comment list. Pick the kind of comment you want.

> [tab] Whole page
>
> Type in the box labeled **Comment on the whole page** and click **Comment**.

> [tab] A quote
>
> Select the text you mean on the page, then click **Comment on selection** in the top bar. Write your note and click **Comment**. The quote shows at the top of the comment.

> [tab] A spot in an image or PDF
>
> On an image or a PDF, switch to the **Pin** tool, then click where you want to comment. On a touch screen, tap that spot instead. Use **Select** to go back to selecting text. A PDF pin remembers its page number.

> [!NOTE]
>
> If you change a page after someone pinned a spot, the comment shows a note that the image or file changed since the pin was placed.

## Format a comment

A comment can be 1 to 2,000 characters. These styles work:

* **Bold** and *italic*
* `Inline code` and fenced code blocks
* Bulleted and numbered lists (one level)
* Block quotes
* Links, written as `[text](url)` or pasted as a plain web address (http and https only)

Anything else shows as plain text. Comments never run HTML.

## Reply, edit, and resolve

* Click **Reply** under a comment to answer in the same thread. A reply does not reopen a resolved thread.
* Click **Resolve** to mark a thread done. A resolved thread can be reopened with **Reopen**. Click **Hide resolved** in the comment list to tidy up.
* You can edit or delete your own comments from the comment's actions menu.

> [!NOTE]
>
> Resolving a thread also closes any [ask](https://docs.open-artifacts.com/comments-and-asks/asks.md) in it.

## Who can comment

The page owner decides, under **Who can comment** in the page's Share panel.

| Page | Choices |
| - | - |
| A public page | **Anyone who can open it**, **Logged-in people**, or **Off** |
| Any other page | **On** or **Off** |

With **Logged-in people**, visitors who are not logged in can read comments but not add them. They see "Log in to comment". With **Anyone who can open it**, a visitor who is not logged in sees an optional **Your name** box (up to 50 characters). If they leave it empty, the comment shows as "A guest". With **Off**, comments are hidden and nobody can add them.

## Comment emails

Open Artifacts can email people about comments. You get an email only when it is about you:

| You get an email when | Reason shown in the email |
| - | - |
| Someone comments on a page you own | you own this artifact |
| Someone replies in a thread you are in | you're in this thread |
| An ask is put to you | the question is for you |

Also:

* You never get an email for your own comment.
* An @-mention of an agent does not email anyone. See [Mention an agent](https://docs.open-artifacts.com/comments-and-asks/mention-an-agent.md).

- Only team members get these emails. Guests do not.
- You get at most one email per thread every 15 minutes. Newer replies in that window stay on the page.
- A daily limit applies, so a busy page cannot flood your inbox. If it holds back some emails, the next email tells you how many weren't emailed.
- Each email has a **Stop comment emails** link.

To turn them on or off yourself, go to **Settings**, then **Notifications**, and use **Email me about comments**. If your instance has no email sender set up, the switch is off and says so.


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