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

# Comment

> The Comment object represents a comment on a Notion page or block. Comments can be viewed or created by a connection that has access to the page/block and the correct capabilities. Please see the [Capabilities guide](/reference/capabilities) for more information on setting up your connection's capabilities.

When [retrieving comments](/reference/list-comments), one or more Comment objects will be returned in the form of an array, sorted in ascending chronological order. When [adding a comment](/reference/create-a-comment) to a page or discussion, the Comment object just added will always be returned. When [updating a comment](/reference/update-a-comment), the updated Comment object will be returned. When [deleting a comment](/reference/delete-a-comment), the deleted Comment object will be returned.

<CodeGroup>
  ```json JSON expandable theme={null}
  {
    "object": "comment",
    "id": "7a793800-3e55-4d5e-8009-2261de026179",
    "parent": {
      "type": "page_id",
      "page_id": "5c6a2821-6bb1-4a7e-b6e1-c50111515c3d"
    },
    "discussion_id": "f4be6752-a539-4da2-a8a9-c3953e13bc0b",
    "created_time": "2022-07-15T21:17:00.000Z",
    "last_edited_time": "2022-07-15T21:17:00.000Z",
    "created_by": {
      "object": "user",
      "id": "e450a39e-9051-4d36-bc4e-8581611fc592"
    },
    "rich_text": [
      {
        "type": "text",
        "text": {
          "content": "Hello world",
          "link": null
        },
        "annotations": {
          "bold": false,
          "italic": false,
          "strikethrough": false,
          "underline": false,
          "code": false,
          "color": "default"
        },
        "plain_text": "Hello world",
        "href": null
      }
    ],
    "attachments": [
      {
        "category": "image",
        "file": {
          "url": "https://s3.us-west-2.amazonaws.com/...",
          "expiry_time": "2025-06-10T21:58:51.599Z"
        }
      }
    ],
    "display_name": {
      "type": "user",
      "resolved_name": "Avo Cado"
    }
  }
  ```
</CodeGroup>

## All comments

<Note>
  **Reminder: Turn on connection comment capabilities**

  Connections must have read comments or insert comments capabilities in order to interact with the Comment object through the API. For more information on connection capabilities, see the [capabilities guide](/reference/capabilities).
</Note>

| Property           | Type                                                                        | Description                                                                                                                                                                                                                  | Example value                                                                                                                                                                  |
| :----------------- | :-------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `object`           | `string`                                                                    | Always `"comment"`                                                                                                                                                                                                           | `"comment"`                                                                                                                                                                    |
| `id`               | `string` (UUIDv4)                                                           | Unique identifier of the comment.                                                                                                                                                                                            | `"ce18f8c6-ef2a-427f-b416-43531fc7c117"`                                                                                                                                       |
| `parent`           | `object`                                                                    | Information about the comment's parent. See [Parent object](/reference/parent-object). Note that comments may only be parented by pages or blocks.                                                                           | `{ "type": "block_id", "block_id": "5d4ca33c-d6b7-4675-93d9-84b70af45d1c" }`                                                                                                   |
| `discussion_id`    | `string` (UUIDv4)                                                           | Unique identifier of the discussion thread that the comment is associated with. See [the guide](/guides/data-apis/working-with-comments#listing-comments-for-a-page-or-block) for more information about discussion threads. | `"ce18f8c6-ef2a-427f-b416-43531fc7c117"`                                                                                                                                       |
| `created_time`     | `string` ([ISO 8601 date and time](https://en.wikipedia.org/wiki/ISO_8601)) | Date and time when this comment was created. Formatted as an [ISO 8601 date time](https://en.wikipedia.org/wiki/ISO_8601) string.                                                                                            | `"2022-07-15T21:46:00.000Z"`                                                                                                                                                   |
| `last_edited_time` | `string` ([ISO 8601 date and time](https://en.wikipedia.org/wiki/ISO_8601)) | Date and time when this comment was updated. Formatted as an [ISO 8601 date time](https://en.wikipedia.org/wiki/ISO_8601) string.                                                                                            | `"2022-07-15T21:46:00.000Z"`                                                                                                                                                   |
| `created_by`       | [Partial User](/reference/user)                                             | User who created the comment.                                                                                                                                                                                                | `{ "object": "user", "id": "e450a39e-9051-4d36-bc4e-8581611fc592" }`                                                                                                           |
| `rich_text`        | [Rich text object](/reference/rich-text)                                    | Content of the comment, which supports rich text formatting, links, and mentions.                                                                                                                                            | `[ { "text": { "content": "Kale", "link": { "type": "url", "url": "https://www.healthline.com/nutrition/10-proven-benefits-of-kale" } } } ]`                                   |
| `attachments`      | [Comment Attachment](/reference/comment-attachment)                         | File attachments on the comment                                                                                                                                                                                              | `[ { "category": "image", "file": { "url": "https://s3.us-west-2.amazonaws.com/9bc6c6e0-32b8-4d55-8c12-3ae931f43a01/meow...", "expiry_time": "2025-06-10T21:58:51.599Z" } } ]` |
| `display_name`     | [Comment Display Name](/reference/comment-display-name)                     | Custom display name on comment                                                                                                                                                                                               | `"display_name": { "type": "custom", "resolved_name": "automated response" }`                                                                                                  |