---
title: "Comment Schema"
description: "Use defineComment() to add Comment structured data. Connect user comments to articles and blog posts with author and date information."
canonical_url: "https://unhead.unjs.io/docs/schema-org/api/schema/comment"
last_updated: "2026-06-30T06:51:00.586Z"
---

## Schema.org Comment

- **Type**: `defineComment(input?: Comment)`<br />

Describes a comment. Usually in the context of an Article or a WebPage.

## Useful Links

- [Comment - Schema.org](https://schema.org/Comment)
- [Comment - Yoast](https://developer.yoast.com/features/schema/pieces/comment)
- [Recipe: Blog](/docs/schema-org/guides/recipes/blog)

## Required properties

- **text** `string`<br />

Content of the comment

## Recommended Properties

- **author** `Person`<br />

The registered author is moved to a root Schema node, resolving the field as reference to a [Person](/docs/schema-org/api/schema/person).

## Defaults

- **@type**: `Comment`
- **@id**: `${canonicalUrl}#/schema/comment/${hash(node)}`
- **about**: Article reference

## Resolves

- `author` will be resolved as root nodes and referenced

## Examples

See the [blog](/docs/schema-org/guides/recipes/blog) recipe for more examples.

### Minimal

```ts
defineComment({
  text: 'This is really cool!',
  author: {
    name: 'Harlan Wilton',
    url: 'https://harlanzw.com',
  }
})
```

## Types

```ts
export interface CommentSimple extends Thing {
  /**
   * The textual content of the comment, stripping HTML tags.
   */
  text: string
  /**
   *  A reference by ID to the parent Article (or WebPage, when no Article is present).
   */
  about?: IdReference
  /**
   * A reference by ID to the Person who wrote the comment.
   */
  author: NodeRelation<Person>
  /**
   * The date and time the comment was created.
   */
  dateCreated?: string
  /**
   * The date and time the comment was last modified.
   */
  dateModified?: string
  /**
   * The number of upvotes the comment has received.
   */
  upvoteCount?: number
  /**
   * The number of downvotes the comment has received.
   */
  downvoteCount?: number
}
```

## Related Schemas

- [Person](/docs/schema-org/api/schema/person) - Comment author
- [Article](/docs/schema-org/api/schema/article) - Commented content