Schema.org · Schema

Schema.org Event

An event happening at a certain time and location, such as a concert, lecture, or festival.

Schema.orgStructured DataLinked DataJSON-LDVocabularySEOWeb StandardsRDFOntology

Properties

Name Type Description
@type string The Schema.org type.
@context string The JSON-LD context URL.
name string The name of the event.
description string A description of the event.
url string URL of the event.
image object An image of the event.
startDate string The start date and time of the event.
endDate string The end date and time of the event.
doorTime string The time admission will commence.
duration string The duration of the event in ISO 8601 format.
eventStatus string The status of the event.
eventAttendanceMode string The attendance mode of the event.
location object The location of the event.
organizer object An organizer of an Event.
performer object A performer at the event.
sponsor object A person or organization that supports a thing through a pledge, promise, or financial contribution.
offers object An offer to provide this item.
audience object An intended audience.
maximumAttendeeCapacity integer The total number of individuals that may attend.
maximumVirtualAttendeeCapacity integer The maximum virtual attendee capacity.
remainingAttendeeCapacity integer The number of attendee places remaining.
previousStartDate string Used for rescheduled or cancelled events to indicate the original start date.
superEvent object An event that this event is a part of.
subEvent object An Event that is part of this event.
inLanguage string The language of the event.
isAccessibleForFree boolean A flag to signal that the item is accessible for free.
review object A review of the event.
aggregateRating object The overall rating, based on a collection of reviews or ratings.
sameAs object URL of a reference Web page that unambiguously indicates the item's identity.
identifier string The identifier property represents any kind of identifier.
View JSON Schema on GitHub

JSON Schema

schema-org-event-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://schema.org/schemas/event.json",
  "title": "Schema.org Event",
  "description": "An event happening at a certain time and location, such as a concert, lecture, or festival.",
  "type": "object",
  "required": ["@type", "name"],
  "properties": {
    "@type": {
      "type": "string",
      "description": "The Schema.org type.",
      "enum": ["Event", "BusinessEvent", "ChildrensEvent", "ComedyEvent", "CourseInstance", "DanceEvent", "DeliveryEvent", "EducationEvent", "ExhibitionEvent", "Festival", "FoodEvent", "Hackathon", "LiteraryEvent", "MusicEvent", "PublicationEvent", "SaleEvent", "ScreeningEvent", "SocialEvent", "SportsEvent", "TheaterEvent", "VisualArtsEvent"]
    },
    "@context": {
      "type": "string",
      "description": "The JSON-LD context URL.",
      "default": "https://schema.org"
    },
    "name": {
      "type": "string",
      "description": "The name of the event."
    },
    "description": {
      "type": "string",
      "description": "A description of the event."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "URL of the event."
    },
    "image": {
      "oneOf": [
        { "type": "string", "format": "uri" },
        { "$ref": "schema-org-image-object-schema.json" }
      ],
      "description": "An image of the event."
    },
    "startDate": {
      "type": "string",
      "format": "date-time",
      "description": "The start date and time of the event."
    },
    "endDate": {
      "type": "string",
      "format": "date-time",
      "description": "The end date and time of the event."
    },
    "doorTime": {
      "type": "string",
      "format": "date-time",
      "description": "The time admission will commence."
    },
    "duration": {
      "type": "string",
      "description": "The duration of the event in ISO 8601 format."
    },
    "eventStatus": {
      "type": "string",
      "enum": ["EventCancelled", "EventMovedOnline", "EventPostponed", "EventRescheduled", "EventScheduled"],
      "description": "The status of the event."
    },
    "eventAttendanceMode": {
      "type": "string",
      "enum": ["MixedEventAttendanceMode", "OfflineEventAttendanceMode", "OnlineEventAttendanceMode"],
      "description": "The attendance mode of the event."
    },
    "location": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "schema-org-place-schema.json" },
        { "$ref": "#/$defs/VirtualLocation" },
        { "$ref": "schema-org-postal-address-schema.json" }
      ],
      "description": "The location of the event."
    },
    "organizer": {
      "oneOf": [
        { "$ref": "schema-org-person-schema.json" },
        { "$ref": "schema-org-organization-schema.json" }
      ],
      "description": "An organizer of an Event."
    },
    "performer": {
      "oneOf": [
        { "$ref": "schema-org-person-schema.json" },
        { "$ref": "schema-org-organization-schema.json" },
        { "type": "array", "items": { "oneOf": [{ "$ref": "schema-org-person-schema.json" }, { "$ref": "schema-org-organization-schema.json" }] } }
      ],
      "description": "A performer at the event."
    },
    "sponsor": {
      "oneOf": [
        { "$ref": "schema-org-person-schema.json" },
        { "$ref": "schema-org-organization-schema.json" }
      ],
      "description": "A person or organization that supports a thing through a pledge, promise, or financial contribution."
    },
    "offers": {
      "oneOf": [
        { "$ref": "schema-org-offer-schema.json" },
        { "type": "array", "items": { "$ref": "schema-org-offer-schema.json" } }
      ],
      "description": "An offer to provide this item."
    },
    "audience": {
      "type": "object",
      "description": "An intended audience.",
      "properties": {
        "@type": { "type": "string", "const": "Audience" },
        "audienceType": { "type": "string", "description": "The target group." }
      }
    },
    "maximumAttendeeCapacity": {
      "type": "integer",
      "description": "The total number of individuals that may attend."
    },
    "maximumVirtualAttendeeCapacity": {
      "type": "integer",
      "description": "The maximum virtual attendee capacity."
    },
    "remainingAttendeeCapacity": {
      "type": "integer",
      "description": "The number of attendee places remaining."
    },
    "previousStartDate": {
      "type": "string",
      "format": "date-time",
      "description": "Used for rescheduled or cancelled events to indicate the original start date."
    },
    "superEvent": {
      "$ref": "#",
      "description": "An event that this event is a part of."
    },
    "subEvent": {
      "oneOf": [
        { "$ref": "#" },
        { "type": "array", "items": { "$ref": "#" } }
      ],
      "description": "An Event that is part of this event."
    },
    "inLanguage": {
      "type": "string",
      "description": "The language of the event."
    },
    "isAccessibleForFree": {
      "type": "boolean",
      "description": "A flag to signal that the item is accessible for free."
    },
    "review": {
      "oneOf": [
        { "$ref": "schema-org-review-schema.json" },
        { "type": "array", "items": { "$ref": "schema-org-review-schema.json" } }
      ],
      "description": "A review of the event."
    },
    "aggregateRating": {
      "$ref": "schema-org-aggregate-rating-schema.json",
      "description": "The overall rating, based on a collection of reviews or ratings."
    },
    "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."
    },
    "identifier": {
      "type": "string",
      "description": "The identifier property represents any kind of identifier."
    }
  },
  "$defs": {
    "VirtualLocation": {
      "type": "object",
      "description": "An online or virtual location for attending events.",
      "properties": {
        "@type": { "type": "string", "const": "VirtualLocation" },
        "url": { "type": "string", "format": "uri", "description": "URL of the virtual location." },
        "name": { "type": "string", "description": "Name of the virtual location or platform." }
      }
    }
  }
}