Event
Schema.org definition: An event happening at a certain time and location, such as a concert, lecture, or festival. Ticketing information may be added via the offers property. Repeated events may be structured as separate Event objects.
Subclass Of: http://schema.org/Thing
Event Types
The Artsdata controlled vocabulary for event types.
The list of types (SKOS concepts) and the concept scheme can be viewed here ArtsdataEventTypes.
For example, an Event can be assigned the type http://kg.artsdata.ca/resource/PerformingArtsEvent showing narrower and broader SKOS concepts.
To suggest edits visit Google Sheet to view the version of the Artsdata controlled vocabulary and mapping to other vocabularies.
Your input is welcome. Please click the link in the top nav bar to open an issue.
How to use
The Artsdata Event Type controlled vocabulary is used along with the schema.org Event type. An Event in Artsdata is a http://schema.org/Event (schema:Event or schema:EventSeries) and optionally an additional type from the Artsdata Event Controlled Vocabulary using the schema:additionalType property.
For example: ex:Event1 a schema:Event ; schema:additionalType <http://kg.artsdata.ca/resource/PerformingArtsEvent> .
To implement schema:Event and schema:additionalType properties in your structured data, please consult Artsdata’s structured data templates.
Reconciling
You can reconcile event types using the Artsdata Reconciliation Service.
To give it a try:
- Go to the W3C entity reconciliation test bench
- Enter the name of an event type, such as Circus
- Click the Reconcile button
To limit the results only to the controlled vocabulary:
- Select the “type” radio button “Artsdata Event Type”
- Click the Reconcile button
Dereferencing
Each SKOS Concept or ConceptScheme URI can be dereferenced individually. Or you can download the entire vocabulary using this download link.
Minting Artsdata IDs for Events
In order for Artsdata to automatically create a unique ID for a performing arts event, the event must minimally have these three attribute–value pairs:
- @Type: Event (or an Event sub-type);
- startTime: dateTime value with a time zone offset;
- location: Place with a sameAs link to a Wikidata or Artsdata URI.
If the startTime value is incomplete or if the Place entity does not have a sameAs link to an identifier, it is still possible to manually assign an ID, as long as at least one of the following properties is used:
- name;
- description;
- url.
In the absence of a Place URI, a postal code can be useful to identify potential duplicate event records.
Properties
Property | Description |
---|---|
sameAs |
URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website.
from class http://schema.org/Thing Artsdata instructionsEnter the URIs of persistent identifiers (Wikidata, Artsdata, ISNI, etc.) and social media urls that unambiguously identify the event. Always add each identifier's complete URI (instead of entering just the ID itself). |
alternateName |
An alias for the item.
from class http://schema.org/Thing Artsdata instructionsEnter an alias for the event title (for example, a subtitle or an alternative title), if applicable. |
description |
A description of the item.
from class http://schema.org/Thing Artsdata instructionsEnter a short description of the event. |
name |
The name of the item.
from class http://schema.org/Thing Artsdata instructionsEnter the just the title of the event. Do not append a separator with the name of the venue (as you would for a webpage's "title" tag) or any other extraneous information. |
url |
URL of the item.
from class http://schema.org/Thing Artsdata instructionsEnter the canonical (aka "official") URL of the event webpage on the organizer's website. |
image |
An image of the item. This can be a URL or a fully described ImageObject.
from class http://schema.org/Thing Artsdata instructionsIdentify the main image for the event page. This can be a URL or a fully described ImageObject. Recommend properties for the nested ImageObject include: creator, creditText, copyrightNotice. |
identifier |
The identifier property represents any kind of identifier for any kind of Thing, such as ISBNs, GTIN codes, UUIDs etc. Schema.org provides dedicated properties for representing many of these, either as textual strings or as URL (URI) links. See background notes for more details.
from class http://schema.org/Thing |
additionalType |
An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. In RDFa syntax, it is better to use the native RDFa syntax - the 'typeof' attribute - for multiple types. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally.
from class http://schema.org/Thing Artsdata instructionsEnter additional types corresponding to the particular type of event. Refer to the Artsdata controlled vocabulary to identify the most appropriate type(s) of all performing arts event types. As a default, we recommend the type ado:PerformingArtsEvent, which denotes « a performing arts work performed for an audience ». |
disambiguatingDescription |
A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
from class http://schema.org/Thing |
mainEntityOfPage |
Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details.
from class http://schema.org/Thing Artsdata instructionsEnter the URL of a page on another website other than organizer's that describes the same event as the canonical URL. |
audience |
An intended audience, i.e. a group for whom something was created.
from class http://schema.org/Event |
location |
The location of for example where the event is happening, an organization is located, or where an action takes place.
from class http://schema.org/Event Artsdata instructionsEnter the place where the event takes place. In the case of a physical venue, the value should be as precise as possible (for example, the performance hall inside the building instead of the building itself). For disambiguation and reconciliation purposes, it is strongly recommended to assign a sameAs link to the place's Wikidata or Artsdata URI. Otherwise, a complete PostalAddress entity, including the postal code, can help with disambiguation. |
duration |
The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format.
from class http://schema.org/Event Artsdata instructionsEnter the length from the startDate to the endDate of the event, in ISO 8601 date format. |
endDate |
The end date and time of the item (in ISO 8601 date format).
from class http://schema.org/Event Artsdata instructionsEnter the date and time when the event ends, in ISO 8601 date format. Be sure to specify the time zone, including the number of hours offset from Coordinated Universal Time (UTC). |
eventStatus |
An eventStatus of an event represents its status; particularly useful when an event is cancelled or rescheduled.
from class http://schema.org/Event Artsdata instructionsIdentify the current programming status of the event, such as scheduled, cancelled or rescheduled. |
inLanguage |
The language of the content or performance or used in an action. Please use one of the language codes from the IETF BCP 47 standard. See also availableLanguage.
from class http://schema.org/Event Artsdata instructionsIdentify the language of the content or performance of the event. Please use one of the language codes from the IETF BCP 47 standard. See also availableLanguage. |
offers |
An offer to provide this item—for example, an offer to sell a product, rent the DVD of a movie, perform a service, or give away tickets to an event. Use businessFunction to indicate the kind of transaction offered, i.e. sell, lease, etc. This property can also be used to describe a Demand. While this property is listed as expected on a number of common types, it can be used in others. In that case, using a second type, such as Product or a subtype of Product, can clarify the nature of the offer.
from class http://schema.org/Event Artsdata instructionsEnter at least one Offer type entity, including the URL of the event's ticketing page. For more information about how to describe Offer type entities, consult the Artsdata event structured data template and Google's documentation: https://developers.google.com/search/docs/appearance/structured-data/event#structured-data-type-definitions |
organizer |
An organizer of an Event.
from class http://schema.org/Event Artsdata instructionsEnter information identifying and describing the organization or person who presents the event. For an organization, this can be a presenting organization or even a company presenting its own production (in which case, the same value would be entered under the performer property). Recommended properties for the nested entity include: name, url, and sameAs (with link pointing to a Wikidata or Artsdata URI). |
performer |
A performer at the event—for example, a presenter, musician, musical group or actor.
from class http://schema.org/Event Artsdata instructionsEnter information identifying and describing the company, group or person(s) delivering the performance. Recommended properties for the nested entity include: name, url, and sameAs (with link pointing to an ISNI, Wikidata or Artsdata URI). |
recordedIn |
The CreativeWork that captured all or part of this Event.
from class http://schema.org/Event |
startDate |
The start date and time of the item (in ISO 8601 date format).
from class http://schema.org/Event Artsdata instructionsEnter the date and time when the event begins, in ISO 8601 date format. Be sure to specify the time zone, including the number of hours offset from Coordinated Universal Time (UTC). |
subEvent |
An Event that is part of this event. For example, a conference event includes many presentations, each of which is a subEvent of the conference.
from class http://schema.org/Event Artsdata instructionsIf your event is of @type EventSeries and consists of a series of performances of the same performance work, please describe each performance as a nested entity under the subEvent property. If your event is of @type Festival and a single web page describes both the festival edition and individual performances presented at the festival, please describe each performance as a nested entity under the subEvent property. |
eventAttendanceMode |
The eventAttendanceMode of an event indicates whether it occurs online, offline, or a mix.
from class http://schema.org/Event Artsdata instructionsIdentify the manner in which audiences attend the event, such as online, offline, or mixed. |