Note: you are viewing the development version of schema.org. See How we work for more details.

ContactPoint

Thing > Intangible > StructuredValue > ContactPoint

A contact point—for example, a Customer Complaints department.
PropertyExpected TypeDescription
Properties from ContactPoint
areaServed AdministrativeArea  or
GeoShape  or
Place  or
Text 
The geographic area where a service or offered item is provided. Supersedes serviceArea.
availableLanguage Language  or
Text 
A 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
contactOption ContactPointOption An option available on this contact point (e.g. a toll-free number or support for hearing-impaired callers).
contactType Text A 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.
email Text Email address.
faxNumber Text The fax number.
hoursAvailable OpeningHoursSpecification The hours during which this service or contact is available.
productSupported Product  or
Text 
The 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").
telephone Text The telephone number.
Properties from Thing
additionalType 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 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.
alternateName Text An alias for the item.
description Text 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 description to be useful for disambiguation.
identifier PropertyValue  or
Text  or
URL 
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 ImageObject  or
URL 
An image of the item. This can be a URL or a fully described ImageObject.
mainEntityOfPage CreativeWork  or
URL 
Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details.
Inverse property: mainEntity.
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 CreativeWork  or
Event 
A CreativeWork or Event about this Thing.
Inverse property: about.
url URL URL of the item.


Instances of ContactPoint may appear as values for the following properties

PropertyOn TypesDescription
bccRecipient Message A sub property of recipient. The recipient blind copied on a message.
ccRecipient Message A sub property of recipient. The recipient copied on a message.
contactPoint HealthInsurancePlan  or
Organization  or
Person 
A contact point for a person or organization. Supersedes, contactPoints.
grantee DigitalDocumentPermission The person, organization, contact point, or audience that has been granted this permission.
homeLocation Person A contact location for a person's residence.
recipient AuthorizeAction  or
CommunicateAction  or
DonateAction  or
GiveAction  or
Message  or
PayAction  or
ReturnAction  or
SendAction  or
TipAction 
A sub property of participant. The participant who is at the receiving end of the action.
servicePhone ServiceChannel The phone number to use to access the service.
serviceSmsNumber ServiceChannel The number to access the service by text message.
toRecipient Message A sub property of recipient. The recipient who was directly sent the message.
workLocation Person A contact location for a person's place of work.

More specific TypesExamples

Example 1
This example shows a JSON-LD description of services that do not necessarily have a direct
human-oriented HTML description. It describes a GovernmentService named "Veterans Affairs Emergency Mental Health",
its operator, service area and service details, such as its Veterans Crisis Line (including  phone contact line
hours of operation, language and other details).
This example is JSON only.
This example is JSON only.
<script type='application/ld+json'>
{
  "@context": "http://schema.org",
  "@type": "GovernmentService",
  "name": "Veterans Affairs Emergency Mental Health",
  "serviceType": "Psychiatric Emergency Services",
  "serviceOperator": {
    "@type": "GovernmentOrganization",
    "name": "US Department of Veterans Affairs"
  },
  "areaServed": {
    "@type": "AdministrativeArea",
    "name": "Massachusetts"
  },
  "audience": {
    "@type": "Audience",
    "name": "Veterans"
  },
  "availableChannel": {
    "@type": "ServiceChannel",
    "name": "Urgent Care Clinic",
    "availableLanguage": {
      "@type": "Language",
      "name": "Spanish",
      "alternateName": "es"
    },
    "serviceLocation": {
      "@type": "Hospital",
      "name": "VA Boston -- West Roxbury",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "1400 VFW Parkway",
        "addressLocality": "West Roxbury",
        "addressRegion": "MA",
        "postalCode": "02132"
      }
    }
  }
}
</script>
Example 2
A fuller example that illustrates multiple contact numbers for a company,
including US toll-free numbers, a hearing-impaired number, and several contact categories.
This example is JSON-only.
This example is JSON-only.
<script type="application/ld+json">
{ "@context" : "http://schema.org",
  "@type" : "Organization",
  "url" : "http://www.t-mobile.com",
  "contactPoint" : [
    { "@type" : "ContactPoint",
      "telephone" : "+1-877-746-0909",
      "contactType" : "customer service",
      "contactOption" : "TollFree",
      "areaServed" : "US"
    } , {
      "@type" : "ContactPoint",
      "telephone" : "+1-505-998-3793",
      "contactType" : "customer service"
    } , {
      "@type" : "ContactPoint",
      "telephone" : "+1-877-296-1018",
      "contactType" : "customer service",
      "contactOption" : ["HearingImpairedSupported","TollFree"] ,
      "areaServed" : "US"
    } , {
      "@type" : "ContactPoint",
      "telephone" : "+1-877-453-1304",
      "contactType" : "technical support",
      "contactOption" : "TollFree",
      "areaServed" : ["US","CA"],
      "availableLanguage" : ["English","French"]
    } , {
      "@type" : "ContactPoint",
      "telephone" : "+1-877-453-1304",
      "contactType" : "bill payment",
      "contactOption" : "TollFree",
      "areaServed" : ["US","CA"]
    } ] }
</script>
Example 3
Example specifying one customer service phone number.
This example is JSON-only.
This example is JSON-only.
<script type="application/ld+json">
{ "@context" : "http://schema.org",
  "@type" : "Organization",
  "url" : "http://www.your-company-site.com",
  "contactPoint" : [
    { "@type" : "ContactPoint",
      "telephone" : "+1-401-555-1212",
      "contactType" : "customer service"
    } ] }
</script>