Role
Represents additional information about a relationship or property. For example a Role can be used to say that a 'member' role linking some SportsTeam to a player occurred during a particular time period. Or that a Person's 'actor' role in a Movie was for some particular characterName. Such properties can be attached to a Role entity, which is then associated with the main entities using ordinary properties like 'member' or 'actor'.
See also blog post.
Extends: Intangible
Properties
| Property | Expected Type | Description |
|---|---|---|
| endDate | DateTime, Date | The end date and time of the item (in ISO 8601 date format). |
| namedPosition | Text, URL | A position played, performed or filled by a person or organization, as part of an organization. For example, an athlete in a SportsTeam might play in the position named 'Quarterback'. |
| roleName | URL, Text | A role played, performed or filled by a person or organization. For example, the team of creators for a comic book might fill the roles named 'inker', 'penciller', and 'letterer'; or an athlete in... |
| startDate | Date, DateTime | The start date and time of the item (in ISO 8601 date format). |
[Thing](https://schema.org.ai/Thing) Properties
| Property | Expected Type | Description |
|---|---|---|
| additionalType | Text, URL | 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... |
| alternateName | Text | An alias for the item. |
| description | Text, TextObject | A description of the item. |
| disambiguatingDescription | Text | 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 descr... |
| identifier | URL, Text, PropertyValue | 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 re... |
| image | ImageObject, URL | An image of the item. This can be a URL or a fully described ImageObject. |
| mainEntityOfPage | CreativeWork, URL | Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details. |
| name | Text | The name of the item. |
| potentialAction | Action | Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role. |
| sameAs | URL | 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. |
| subjectOf | Event, CreativeWork | A CreativeWork or Event about this Thing. |
| url | URL | URL of the item. |
Subtypes
| Type | Description |
|---|---|
| LinkRole | A Role that represents a Web link, e.g. as expressed via the 'url' property. Its linkRelationship property can indicate URL-based and plain textual link types, e.g. those in IANA link registry or o... |
| OrganizationRole | A subclass of Role used to describe roles within organizations. |
| PerformanceRole | A PerformanceRole is a Role that some entity places with regard to a theatrical performance, e.g. in a Movie, TVSeries etc. |