Skip to main content


A physical mailing address.


Name@idTypeDescriptionInherited from
typeschema:type'PostalAddress'The name of the type.Entity
addressCountryschema:addressCountrystringThe country. See note 1.PostalAddress
addressLocalityschema:addressLocalitystringThe locality in which the street address is, and which is in the region. See note 2.PostalAddress
addressRegionschema:addressRegionstringThe region in which the locality is, and which is in the country. See note 3.PostalAddress
alternateNamesschema:alternateNameArray of stringAlternate names (aliases) for the item.Thing
availableLanguagesschema:availableLanguageArray of stringLanguages (human not programming) in which it is possible to communicate with the organization/department etc.ContactPoint
descriptionschema:descriptionArray of BlockContent or Array of InlineContent or stringA description of the item. See note 6.Thing
emailsschema:emailArray of Format 'email'Email address for correspondence.ContactPoint
idschema:idstringThe identifier for this item.Entity
identifiersschema:identifierArray of (PropertyValue or string)Any kind of identifier for any kind of Thing. See note 7.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
postOfficeBoxNumberschema:postOfficeBoxNumberstringThe post office box number.PostalAddress
postalCodeschema:postalCodestringThe postal code. See note 4.PostalAddress
streetAddressschema:streetAddressstringThe street address. See note 5.PostalAddress
telephoneNumbersschema:telephoneArray of stringTelephone numbers for the contact point.ContactPoint
urlschema:urlFormat 'uri'The URL of the item.Thing



  1. addressCountry : For example, United Kingdom. You can also provide the two-letter ISO 3166-1 alpha-2 country code.
  2. addressLocality : For example, London.
  3. addressRegion : For example, California or another appropriate first-level Administrative division
  4. postalCode : For example, 94043.
  5. streetAddress : For example, 10 Downing Street.
  6. 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.
  7. 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).
  8. Available as JSON-LD.
  9. Available as JSON Schema.
  10. This documentation was generated from PostalAddress.schema.yaml.