Comment Schema · Unhead

[Unhead Home](https://unhead.unjs.io/ "Home")

- [Docs](https://unhead.unjs.io/docs/vue/head/guides/get-started/overview)
- [Tools](https://unhead.unjs.io/tools)
- [Learn](https://unhead.unjs.io/learn/guides/what-is-capo)

[Releases](https://unhead.unjs.io/releases)

Search…```k`` /`

[Unhead on GitHub](https://github.com/unjs/unhead)

[User Guides](https://unhead.unjs.io/docs/vue/schema-org/guides/get-started/overview)

[API](https://unhead.unjs.io/docs/vue/schema-org/api/composables/use-schema-org)

Vue

- [Switch to Vue](https://unhead.unjs.io/docs/vue/schema-org/api/schema/comment)
- [Switch to TypeScript](https://unhead.unjs.io/docs/typescript/schema-org/api/schema/comment)
- [Switch to React](https://unhead.unjs.io/docs/react/schema-org/api/schema/comment)
- [Switch to Svelte](https://unhead.unjs.io/docs/svelte/schema-org/api/schema/comment)
- [Switch to Solid.js](https://unhead.unjs.io/docs/solid-js/schema-org/api/schema/comment)
- [Switch to Angular](https://unhead.unjs.io/docs/angular/schema-org/api/schema/comment)
- [Switch to Nuxt](https://unhead.unjs.io/docs/nuxt/schema-org/api/schema/comment)

v3 (beta)

You're viewing **Unhead v3 beta** documentation.

Schema.org

- [Discord Support](https://discord.com/invite/275MBUBvgP)
- [Vue Playground](https://stackblitz.com/edit/github-1ftqrmwn)

- Composables
  - [`useSchemaOrg()`](https://unhead.unjs.io/docs/vue/schema-org/api/composables/use-schema-org)
- Nodes
  - [Article](https://unhead.unjs.io/docs/vue/schema-org/api/schema/article)
  - [Book Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/book)
  - [Breadcrumb Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/breadcrumb)
  - [Comment Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/comment)
  - [Course Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/course)
  - [Dataset Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/dataset)
  - [Event Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/event)
  - [Food Establishment Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/food-establishment)
  - [HowTo](https://unhead.unjs.io/docs/vue/schema-org/api/schema/how-to)
  - [Image Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/image)
  - [ItemList](https://unhead.unjs.io/docs/vue/schema-org/api/schema/item-list)
  - [JobPosting](https://unhead.unjs.io/docs/vue/schema-org/api/schema/job-posting)
  - [LocalBusiness](https://unhead.unjs.io/docs/vue/schema-org/api/schema/local-business)
  - [Movie Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/movie)
  - [Music Album Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/music-album)
  - [Music Group Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/music-group)
  - [Music Playlist Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/music-playlist)
  - [Music Recording Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/music-recording)
  - [Organization](https://unhead.unjs.io/docs/vue/schema-org/api/schema/organization)
  - [Person Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/person)
  - [Podcast Episode Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/podcast-episode)
  - [Podcast Season Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/podcast-season)
  - [Podcast Series Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/podcast-series)
  - [Product Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/product)
  - [Question Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/question)
  - [Recipe Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/recipe)
  - [Service Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/service)
  - [SoftwareApplication](https://unhead.unjs.io/docs/vue/schema-org/api/schema/software-app)
  - [TV Episode Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/tv-episode)
  - [TV Season Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/tv-season)
  - [TV Series Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/tv-series)
  - [Video Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/video)
  - [WebPage Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/webpage)
  - [WebSite Schema](https://unhead.unjs.io/docs/vue/schema-org/api/schema/website)

Schema

# Comment Schema

[Copy for LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/comment.md)

Last updated Jan 19, 2026 by [Harlan Wilton](https://github.com/harlan-zw) in [docs: sync](https://github.com/unjs/unhead/commit/d2f86454774aa60706628b46a850653e1e4d56d9).

On this page

- [Schema.org Comment](#schemaorg-comment)
- [Useful Links](#useful-links)
- [Required properties](#required-properties)
- [Recommended Properties](#recommended-properties)
- [Defaults](#defaults)
- [Resolves](#resolves)
- [Examples](#examples)
- [Types](#types)
- [Related Schemas](#related-schemas)

## [Schema.org Comment](#schemaorg-comment)

- **Type**: `defineComment(input?: Comment)`Describes a comment. Usually in the context of an Article or a WebPage.

## [Useful Links](#useful-links)

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

## [Required properties](#required-properties)

- **text** `string`Content of the comment

## [Recommended Properties](#recommended-properties)

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

## [Defaults](#defaults)

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

## [Resolves](#resolves)

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

## [Examples](#examples)

See the [blog](https://unhead.unjs.io/docs/schema-org/guides/recipes/blog) recipe for more examples.

### [Minimal](#minimal)

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

## [Types](#types)

```
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](#related-schemas)

- [Person](https://unhead.unjs.io/docs/schema-org/api/schema/person) - Comment author
- [Article](https://unhead.unjs.io/docs/schema-org/api/schema/article) - Commented content

[Edit this page](https://github.com/unjs/unhead/edit/main/docs/schema-org/5.api/9.schema/comment.md)

[Markdown For LLMs](https://raw.githubusercontent.com/unjs/unhead/refs/heads/main/docs/schema-org/5.api/9.schema/comment.md)

Did this page help you?

[Breadcrumb Schema Use defineBreadcrumb() to add BreadcrumbList structured data. Display clickable navigation paths in Google search results for better user experience.](https://unhead.unjs.io/docs/schema-org/api/schema/breadcrumb) [Course Schema Use defineCourse() to add Course structured data. Enable rich results for educational courses with provider, description, and course details.](https://unhead.unjs.io/docs/schema-org/api/schema/course)

On this page

- [Schema.org Comment](#schemaorg-comment)
- [Useful Links](#useful-links)
- [Required properties](#required-properties)
- [Recommended Properties](#recommended-properties)
- [Defaults](#defaults)
- [Resolves](#resolves)
- [Examples](#examples)
- [Types](#types)
- [Related Schemas](#related-schemas)

[GitHub](https://github.com/unjs/unhead) [ Discord](https://discord.com/invite/275MBUBvgP)

[ /llms.txt](https://unhead.unjs.io/llms.txt)

[Part of the UnJS ecosystem](https://unjs.io/)

### Articles

- [Announcing Unhead v2](https://unhead.unjs.io/v2)

### Tools

- [Meta Tag Generator](https://unhead.unjs.io/tools/meta-tag-generator)
- [OG Image Generator](https://unhead.unjs.io/tools/og-image-generator)
- [Schema.org Generator](https://unhead.unjs.io/tools/schema-generator)

### Head

- [Overview](https://unhead.unjs.io/docs/vue/head/guides/get-started/overview)
- [Introduction to Unhead](https://unhead.unjs.io/docs/vue/head/guides/get-started/intro-to-unhead)
- [Starter Recipes](https://unhead.unjs.io/docs/vue/head/guides/get-started/starter-recipes)

### Schema.org

- [Introduction](https://unhead.unjs.io/docs/vue/schema-org/guides/get-started/overview)

Copyright © 2025-2026 Harlan Wilton - [MIT License](https://github.com/unjs/unhead/blob/main/license)