---
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-08-11T00:38:01.973Z"
---

## Schema.org Comment

- **Type**: `defineComment<T extends Record<string, any>>(input?: Comment & T)`<br />

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

## Useful Links

- [Comment - Schema.org](https://schema.org/Comment)
- [Recipe: Blog](/docs/schema-org/guides/recipes/blog)

## Required properties

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

Content of the comment.
- **author** `Person`<br />

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

## Defaults

- **@type**: `Comment`
- **@id**: `${canonicalUrl}#/schema/comment/{n}`
- **about**: Article reference

## Resolves

- `author` is resolved as a root Person node and replaced with an ID reference
- `dateCreated` and `dateModified` accept Date objects and are serialized as ISO 8601 strings

## Examples

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

### Minimal

```ts
defineComment({
  text: 'The setup guide answered my question.',
  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?: ResolvableDate
  /**
   * The date and time the comment was last modified.
   */
  dateModified?: ResolvableDate
  /**
   * 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