Schema.org · Schema

Schema.org Review

A review of an item, such as a product, service, or creative work.

Schema.orgStructured DataLinked DataJSON-LDVocabularySEOWeb StandardsRDFOntology

Properties

Name	Type	Description
@type	string	The Schema.org type.
@context	string
name	string	The name of the review.
description	string	A description of the review.
reviewBody	string	The actual body of the review.
reviewRating	object	The rating given in this review.
author	object	The author of this review.
publisher	object	The publisher of this review.
datePublished	string	Date of first publication.
dateModified	string	The date the review was most recently modified.
itemReviewed	object	The item that is being reviewed.
positiveNotes	object	Positive aspects of the reviewed item.
negativeNotes	object	Negative aspects of the reviewed item.
url	string	URL of the review.
sameAs	object	URL of a reference Web page that unambiguously indicates the item's identity.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://schema.org/schemas/review.json",
  "title": "Schema.org Review",
  "description": "A review of an item, such as a product, service, or creative work.",
  "type": "object",
  "required": ["@type"],
  "properties": {
    "@type": {
      "type": "string",
      "description": "The Schema.org type.",
      "enum": ["Review", "ClaimReview", "CriticReview", "EmployerReview", "MediaReview", "Recommendation", "UserReview"]
    },
    "@context": {
      "type": "string",
      "default": "https://schema.org"
    },
    "name": {
      "type": "string",
      "description": "The name of the review."
    },
    "description": {
      "type": "string",
      "description": "A description of the review."
    },
    "reviewBody": {
      "type": "string",
      "description": "The actual body of the review."
    },
    "reviewRating": {
      "$ref": "#/$defs/Rating",
      "description": "The rating given in this review."
    },
    "author": {
      "oneOf": [
        { "$ref": "schema-org-person-schema.json" },
        { "$ref": "schema-org-organization-schema.json" }
      ],
      "description": "The author of this review."
    },
    "publisher": {
      "$ref": "schema-org-organization-schema.json",
      "description": "The publisher of this review."
    },
    "datePublished": {
      "type": "string",
      "format": "date",
      "description": "Date of first publication."
    },
    "dateModified": {
      "type": "string",
      "format": "date",
      "description": "The date the review was most recently modified."
    },
    "itemReviewed": {
      "type": "object",
      "description": "The item that is being reviewed.",
      "properties": {
        "@type": { "type": "string" },
        "name": { "type": "string" },
        "url": { "type": "string", "format": "uri" }
      }
    },
    "positiveNotes": {
      "type": "object",
      "description": "Positive aspects of the reviewed item.",
      "properties": {
        "@type": { "const": "ItemList" },
        "itemListElement": { "type": "array", "items": { "type": "object", "properties": { "@type": { "const": "ListItem" }, "name": { "type": "string" } } } }
      }
    },
    "negativeNotes": {
      "type": "object",
      "description": "Negative aspects of the reviewed item.",
      "properties": {
        "@type": { "const": "ItemList" },
        "itemListElement": { "type": "array", "items": { "type": "object", "properties": { "@type": { "const": "ListItem" }, "name": { "type": "string" } } } }
      }
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "URL of the review."
    },
    "sameAs": {
      "oneOf": [
        { "type": "string", "format": "uri" },
        { "type": "array", "items": { "type": "string", "format": "uri" } }
      ],
      "description": "URL of a reference Web page that unambiguously indicates the item's identity."
    }
  },
  "$defs": {
    "Rating": {
      "type": "object",
      "description": "A rating is an evaluation on a numeric scale.",
      "properties": {
        "@type": { "type": "string", "const": "Rating" },
        "ratingValue": { "oneOf": [{ "type": "number" }, { "type": "string" }], "description": "The rating for the content." },
        "bestRating": { "oneOf": [{ "type": "number" }, { "type": "string" }], "description": "The highest value allowed in this rating system." },
        "worstRating": { "oneOf": [{ "type": "number" }, { "type": "string" }], "description": "The lowest value allowed in this rating system." },
        "ratingExplanation": { "type": "string", "description": "A short explanation for the rating." }
      }
    }
  }
}