Skip to content

PostalAddress ​

Breadcrumb: Thing > Intangible > StructuredValue > ContactPoint > PostalAddress

The mailing address.

Parent types ​

ContactPoint

Properties ​

Properties for PostalAddress ​

PropertyExpected typeDefined onDescription
addressCountryCountry, TextPostalAddressThe country. Recommended to be in 2-letter ISO 3166-1 alpha-2 format, for example "US". For backward compatibility, a 3-letter ISO 3166-1 alpha-3 country code such as "SGP" or a full country name such as "Singapore" can also be used.
addressLocalityTextPostalAddressThe locality in which the street address is, and which is in the region. For example, Mountain View.
addressRegionAdministrativeArea, TextPostalAddressThe region in which the locality is, and which is in the country. For example, California or another appropriate first-level Administrative division such as the Province in Italy or Region in Germany.
extendedAddressTextPostalAddressAn address extension such as an apartment number, C/O or alternative name.
postalCodeTextPostalAddressThe postal code. For example, 94043.
postOfficeBoxNumberTextPostalAddressThe post office box number for PO box addresses.
streetAddressTextPostalAddressThe street address. For example, 1600 Amphitheatre Pkwy.

Inherited properties ​

PropertyExpected typeInherited fromDescription
additionalTypeText, URLThingAn 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. Typically the value is a URI-identified RDF class, and in this case corresponds to the use of rdf:type in RDF. Text values can be used sparingly, for cases where useful information can be added without their being an appropriate schema to reference. In the case of text values, the class label should follow the schema.org style guide.
alternateNameTextThingAn alias for the item.
areaServedAdministrativeArea, GeoShape, Place, TextContactPointThe geographic area where a service or offered item is provided.
availableLanguageLanguage, TextContactPointA language someone may use with or at the item, service or place. Please use one of the language codes from the IETF BCP 47 standard. See also inLanguage.
contactOptionContactPointOptionContactPointAn option available on this contact point (e.g. a toll-free number or support for hearing-impaired callers).
contactTypeTextContactPointA person or organization can have different contact points, for different purposes. For example, a sales contact point, a PR contact point and so on. This property is used to specify the kind of contact point.
descriptionText, TextObjectThingA description of the item.
disambiguatingDescriptionTextThingA 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.
emailTextContactPointEmail address.
faxNumberTextContactPointThe fax number.
hoursAvailableOpeningHoursSpecificationContactPointThe hours during which this service or contact is available.
identifierPropertyValue, Text, URLThingThe 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.
imageImageObject, URLThingAn image of the item. This can be a URL or a fully described ImageObject.
mainEntityOfPageCreativeWork, URLThingIndicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details.
nameTextThingThe name of the item.
ownerOrganization, PersonThingA person or organization who owns this Thing.
potentialActionActionThingIndicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
productSupportedProduct, TextContactPointThe product or service this support contact point is related to (such as product support for a particular product line). This can be a specific product or product line (e.g. "iPhone") or a general category of products or services (e.g. "smartphones").
sameAsURLThingURL 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.
serviceAreaAdministrativeArea, GeoShape, PlaceContactPointThe geographic area where the service is provided.
subjectOfCreativeWork, EventThingA CreativeWork or Event about this Thing.
telephoneTextContactPointThe telephone number.
urlURLThingURL of the item.

Example ​

json
{
  "@context": "https://schema.org",
  "@type": "PostalAddress",
  "name": "Example Name",
  "description": "A short description.",
  "url": "/example",
  "addressCountry": "Example value",
  "addressLocality": "Example value"
}