Skip to main content

Property Value

A property-value pair.

Always use specific properties when they exist and you can populate them. Using PropertyValue as a substitute will typically not convey as much semantic information as using the specific property. Most of the time a PropertyValue node will need a value property (e.g. most of the examples on have one) so this schema make that property required. This type is mainly provided for use in Thing.identifiers (see the notes there).


Name@idTypeDescriptionInherited from
valueschema:valueboolean or integer or number or stringThe value of the property. See note 1.PropertyValue
alternateNamesschema:alternateNameArray of stringAlternate names (aliases) for the item.Thing
descriptionschema:descriptionArray of BlockContent or Array of InlineContent or stringA description of the item. See note 2.Thing
idschema:idstringThe identifier for this item.Entity
identifiersschema:identifierArray of (PropertyValue or string)Any kind of identifier for any kind of Thing. See note 3.Thing
imagesschema:imageArray of (ImageObject or Format 'uri')Images of the item.Thing
metastencila:metaobjectMetadata associated with this item.Entity
nameschema:namestringThe name of the item.Thing
propertyIDschema:propertyIDstringA commonly used identifier for the characteristic represented by the property.PropertyValue
urlschema:urlFormat 'uri'The URL of the item.Thing


  1. value : This follows the expected types of except for StructuredValue, which at the time of writing was not implemented in this schema.
  2. description : Allows for the description to be an array of nodes (e.g. an array of inline content, or a couple of paragraphs), or a string. The minItems restriction avoids a string being coerced into an array with a single string item.
  3. identifiers : Some identifiers have specific properties e.g the issn property for the Periodical type. These should be used in preference to this property which is intended for identifiers that do not yet have a specific property. Identifiers can be represented as strings, but using a PropertyValue will usually be better because it allows for propertyID (i.e. the type of identifier).
  • Parent: Thing
  • Descendants: None

Available as


This documentation was generated from PropertyValue.schema.yaml.