> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://notion.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://notion.ferndocs.com/_mcp/server.

# Comment display name

The Comment Display Name object represents the author name that shows up for a comment. This overrides the default author name when specified.

## Request format (input)

### Object properties

| Parameter | Type | Description | Example value |
| :--- | :--- | :--- | :--- |
| `type` | `string`  (enum) | Possible type values are:`"integration"`, `"user"`, or `"custom"` | `"user"` |
| `custom` | `object` | If the type is `"custom"`, include a custom object specifying the custom name  `"custom": {   "name": <Custom Name>	 }` | `"custom": {  "name": "Notion Bot"	 }` |


- `"integration"`: name of the [integration](/docs/getting-started)
- `"user"`: name of the user who authenticated the integration (only for [Public Integrations](/docs/getting-started#internal-vs-public-integrations))
- `"custom"`: any custom name

Example of a Create Comment request with custom display name:

**`API request`**

```json API request
{
  "parent": {
    "page_id": "d0a1ffaf-a4d8-4acf-a1ed-abae6e110418"
  },
  "rich_text": [
    {
      "text": {
        "content": "Thanks for checking us out!"
      }
    }
  ],
  "display_name": {
    "type": "custom",
    "custom": {
      "name": "Notion Bot"
    }
  }
}
```

## Response format (output)

### Object properties

The response of Comment APIs like [Create comment](/reference/create-a-comment) contains `attachments` with the following fields:

| Field           | Type            | Description                                                       | Example value  |
| :-------------- | :-------------- | :---------------------------------------------------------------- | :------------- |
| `type`          | `string` (enum) | Possible type values are:`"integration"`, `"user"`, or `"custom"` | `"custom"`     |
| `resolved_name` | `string`        | The custom display name shown in a comment                        | `"Notion Bot"` |

<br />

**`API Response`**

```json API Response
{
  ...existing parameters omitted,
  "display_name": {
    "type": "custom",
    "resolved_name": "Notion Bot"
  }
}
```