• Thing

CreativeWork Schema

The most generic kind of creative work, including books, movies, photographs, software programs, etc.

Properties of Creative­WorkExpected TypeDescription
about The subject matter of the content.
abstract An abstract is a short description that summarizes a Creative­Work.
access­Mode The human sensory perceptual system or cognitive faculty through which a person may process or perceive information. Expected values include: auditory, tactile, textual, visual, color­Dependent, chart­On­Visual, chem­On­Visual, diagram­On­Visual, math­On­Visual, music­On­Visual, text­On­Visual.
accessibility­API Indicates that the resource is compatible with the referenced accessibility API (Web­Schemas wiki lists possible values ).
accessibility­Control Identifies input methods that are sufficient to fully control the described resource (Web­Schemas wiki lists possible values ).
accessibility­Feature Content features of the resource, such as accessible media, alternatives and supported enhancements for accessibility (Web­Schemas wiki lists possible values ).
accessibility­Hazard A characteristic of the described resource that is physiologically dangerous to some users. Related to WCAG 2.0 guideline 2.3 (Web­Schemas wiki lists possible values ).
accessibility­Summary A human-readable summary of specific accessibility features or deficiencies, consistent with the other accessibility metadata but expressing subtleties such as "short descriptions are present but long descriptions will be needed for non-visual users" or "short descriptions are present and no long descriptions are needed."
acquire­License­Page  or Indicates a page documenting how licenses can be purchased or otherwise acquired, for the current item.
aggregate­Rating The overall rating, based on a collection of reviews or ratings, of the item.
alternative­Headline A secondary title of the Creative­Work.
associated­Media A media object that encodes this Creative­Work. This property is a synonym for encoding.
audience An intended audience, i.e. a group for whom something was created.
audio  or An embedded audio object.
award An award won by or for this item.
awards Awards won by or for this item.
citation  or A citation or reference to another creative work, such as another publication, web page, scholarly article, etc.
comment Comments, typically from users.
comment­Count The number of comments this Creative­Work (e.g. Article, Question or Answer) has received. This is most applicable to works published in Web sites with commenting system; additional comments may exist elsewhere.
conditions­Of­Access Conditions that affect the availability of, or method(s) of access to, an item. Typically used for real world items such as an Archive­Component held by an Archive­Organization. This property is not suitable for use as a general Web access control mechanism. It is expressed only in natural language.

For example "Available by appointment from the Reading Room" or "Accessible only from logged-in accounts ".
content­Reference­Time The specific time described by a creative work, for works (e.g. articles, video objects etc.) that emphasise a particular moment within an Event.
copyright­Year The year during which the claimed copyright for the Creative­Work was first asserted.
correction  or Indicates a correction to a Creative­Work, either via a Correction­Comment, textually or in another document.
date­Created  or The date on which the Creative­Work was created or the item was added to a Data­Feed.
date­Modified  or The date on which the Creative­Work was most recently modified or when the item's entry was modified within a Data­Feed.
date­Published  or Date of first broadcast/publication.
discussion­Url A link to the page containing the comments of the Creative­Work.
educational­Use The purpose of a work in the context of education; for example, 'assignment', 'group work'.
encoding A media object that encodes this Creative­Work. This property is a synonym for associated­Media.
encoding­Format  or Media type typically expressed using a MIME format (see IANA site  and MDN reference ) e.g. application/zip for a Software­Application binary, audio/mpeg for .mp3 etc.).

In cases where a Creative­Work has several media type representations, encoding  can be used to indicate each Media­Object alongside particular encoding­Format  information.

Unregistered or niche encoding and file formats can be indicated instead via the most appropriate URL, e.g. defining Web page or a Wikipedia/Wikidata entry.
encodings A media object that encodes this Creative­Work.
example­Of­Work A creative work that this work is an example/instance/realization/derivation of.
expires Date the content expires and is no longer useful or available. For example a Video­Object or News­Article whose availability or relevance is time-limited, or a Claim­Review fact check whose publisher wants to indicate that it may no longer be relevant (or helpful to highlight) after some date.
file­Format  or Media type, typically MIME format (see IANA site ) of the content e.g. application/zip of a Software­Application binary. In cases where a Creative­Work has several media type representations, 'encoding' can be used to indicate each Media­Object alongside particular file­Format information. Unregistered or niche file formats can be indicated instead via the most appropriate URL, e.g. defining Web page or a Wikipedia entry.
funder  or A person or organization that supports (sponsors) something through some kind of financial contribution.
genre  or Genre of the creative work, broadcast channel or group.
has­Part Indicates an item or Creative­Work that is part of this item, or Creative­Work (in some sense).
headline Headline of the article.
in­Language  or 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 available­Language .
interaction­Statistic The number of interactions for the Creative­Work using the Web­Site or Software­Application. The most specific child type of Interaction­Counter should be used.
interactivity­Type The predominant mode of learning supported by the learning resource. Acceptable values are 'active', 'expositive', or 'mixed'.
is­Accessible­For­Free A flag to signal that the item, event, or place is accessible for free.
is­Family­Friendly Indicates whether this content is family friendly.
is­Part­Of  or Indicates an item or Creative­Work that this item, or Creative­Work (in some sense), is part of.
keywords Keywords or tags used to describe this content. Multiple entries in a keywords list are typically delimited by commas.
learning­Resource­Type The predominant type or kind characterizing the learning resource. For example, 'presentation', 'handout'.
license  or A license document that applies to this content, typically indicated by URL.
main­Entity Indicates the primary entity described in some page or other Creative­Work.
material  or A material that something is made from, e.g. leather, wool, cotton, paper.
mentions Indicates that the Creative­Work contains a reference to, but is not necessarily about a concept.
offers  or 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 business­Function  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.
position  or The position of an item in a series or sequence of items.
publishing­Principles  or The publishing­Principles property indicates (typically via URL) a document describing the editorial principles of an Organization (or individual e.g. a Person writing a blog) that relate to their activities as a publisher, e.g. ethics or diversity policies. When applied to a Creative­Work (e.g. News­Article) the principles are those of the party primarily responsible for the creation of the Creative­Work.

While such policies are most typically expressed in natural language, sometimes related information (e.g. indicating a funder ) can be expressed using schema.org terminology.
review A review of the item.
reviews Review of the item.
schema­Version  or Indicates (by URL or string) a particular version of a schema used in some Creative­Work. For example, a document could declare a schema­Version using an URL such as http://schema.org/version/2.0/  if precise indication of schema version was required by some application.
sd­Date­Published Indicates the date on which the current structured data was generated / published. Typically used alongside sd­Publisher 
sd­License  or A license document that applies to this structured data, typically indicated by URL.
sponsor  or A person or organization that supports a thing through a pledge, promise, or financial contribution. e.g. a sponsor of a Medical Study or a corporate sponsor of an event.
temporal  or The "temporal" property can be used in cases where more specific properties (e.g. temporal­Coverage , date­Created , date­Modified , date­Published ) are not known to be appropriate.
temporal­Coverage  or The temporal­Coverage of a Creative­Work indicates the period that the content applies to, i.e. that it describes, either as a Date­Time or as a textual string indicating a time period in ISO 8601 time interval format . In the case of a Dataset it will typically indicate the relevant time period in a precise notation (e.g. for a 2011 census dataset, the year 2011 would be written "2011/2012"). Other forms of content e.g. Scholarly­Article, Book, TVSeries or TVEpisode may indicate their temporal­Coverage in broader terms - textually or via well-known URL. Written works such as books may sometimes have precise temporal coverage too, e.g. a work set in 1939 - 1945 can be indicated in ISO 8601 interval format format via "1939/1945".

Open-ended date ranges can be written with ".." in place of the end date. For example, "2015-11/.." indicates a range beginning in November 2015 and with no specified final date. This is tentative and might be updated in future when ISO 8601 is officially updated.
text The textual content of this Creative­Work.
thumbnail­Url A thumbnail image relevant to the Thing.
translation­Of­Work The work that this work has been translated from. e.g. 物种起源 is a translation­Of “On the Origin of Species”
typical­Age­Range The typical expected age range, e.g. '7-9', '11-'.
usage­Info  or The schema.org usage­Info  property indicates further information about a Creative­Work. This property is applicable both to works that are freely available and to those that require payment or other transactions. It can reference additional information e.g. community expectations on preferred linking and citation conventions, as well as purchasing details. For something that can be commercially licensed, usage­Info can provide detailed, resource-specific information about licensing options.

This property can be used alongside the license property which indicates license(s) applicable to some piece of content. The usage­Info property can provide information about other licensing options, e.g. acquiring commercial usage rights for an image that is also available under non-commercial creative commons licenses.
version  or The version of the Creative­Work embodied by a specified resource.
video  or An embedded video object.
work­Example Example/instance/realization/derivation of the concept of this creative work. eg. The paperback edition, first edition, or e­Book.
work­Translation A work that is a translation of the content of this work. e.g. 西遊記 has an English work­Translation “Journey to the West”,a German work­Translation “Monkeys Pilgerfahrt” and a Vietnamese translation Tây du ký bình khảo.
Properties inherited from ThingExpected TypeDescription
additional­Type 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.
alternate­Name An alias for the item.
description A description of the item.
disambiguating­Description 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.
identifier  or 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.
image  or An image of the item. This can be a URL or a fully described Image­Object.
main­Entity­Of­Page  or Indicates a page (or other Creative­Work) for which this thing is the main entity being described. See background notes  for details.
name The name of the item.
potential­Action Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
same­As 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.
subject­Of  or A Creative­Work or Event about this Thing.
url URL of the item.