Schema
Organization

TASKS LIST

  • Add introduction
  • Create use cases
  • Document schema
  • Create references to standards and protocols

Organization (Organization) schema.

The Organization Schema is designed to provide a comprehensive and accessible overview of an organization for the general public and interested stakeholders. It focuses on delivering soft information that encompasses the organization's mission, values, key activities, and general market presence. This schema aims to highlight the organization's contributions, achievements, and overall impact on the community and industry it serves. It serves as a gateway for potential customers, partners, and the wider public to gain insights into what the organization stands for, its goals, and how it positions itself in the market.

Note on Entity Schema: While the Organization Schema focuses on marketing and general knowledge about an organization, the Entity Schema delves deeper into the legal aspects and decision-making structures of the organization. It is designed for due diligence purposes, providing detailed information on legal status, ownership, and key individuals with decision-making authority. This schema is particularly useful for stakeholders requiring a deeper understanding of the organization's legal and operational framework.

Example

{
    "@context": "https://schema.org",
    "@type": "Organization",
    "image": "https://www.example.com/example_image.jpg",
    "url": "https://www.example.com",
    "sameAs": ["https://example.net/profile/example1234", "https://example.org/example1234"],
    "logo": "https://www.example.com/images/logo.png",
    "name": "Example Corporation",
    "description": "The example corporation is well-known for producing high-quality widgets",
    "email": "contact@example.com",
    "telephone": "+47-99-999-9999",
    "address": {
        "@type": "PostalAddress",
        "streetAddress": "Rue Improbable 99",
        "addressLocality": "Paris",
        "addressCountry": "FR",
        "addressRegion": "Ile-de-France",
        "postalCode": "75001"
    },
    "vatID": "FR12345678901",
    "iso6523Code": "0199:724500PMK2A2M1SQQ228"
}

Schema data type definitions

NameTypeDescription
nameText (opens in a new tab)The name of your organization.
alternateNameText (opens in a new tab)Another common name that your organization goes by, if applicable.
LegalNameText (opens in a new tab)The registered, legal name of your Organization, if applicable and different from the name property.
descriptionText (opens in a new tab)A detailed description of your organization, if applicable.
logoURL (opens in a new tab)A logo that is representative of your organization, if applicable.

Image guidelines:

• The image must be 112x112px, at minimum.
• The image URL must be crawlable and indexable.
• The image file format must be oneOf[png, jpeg]
• Make sure the image looks how you intend it to look on a purely white background (for example, if the logo is mostly white or gray, it may not look how you want it to look when displayed on a white background).
urlURL (opens in a new tab)The URL of the website of your organization, if applicable.
telephoneText (opens in a new tab)A business phone number meant to be the primary contact method.
emailText (opens in a new tab)The email address to contact your business, if applicable.
addressPostalAddress (opens in a new tab)The address (physical or mailing) of your organization, if applicable. Include all properties that apply to your country. The more properties you provide, the higher quality the result is for users. You can provide multiple addresses if you have a location in multiple cities, states, or countries.
address
.streetAddress		Text (opens in a new tab)The full street address of your postal address.
address
.addressLocality		Text (opens in a new tab)The city of your postal address.
address
.addressRegion		Text (opens in a new tab)The region of your postal address, if applicable. For example, a state.
address
.postalCode		Text (opens in a new tab)The postal code for your address.
address
.addressCountry		Text (opens in a new tab)The country for your postal address, using the two-letter ISO 3166-1 alpha-2 country code (opens in a new tab).
foundingDateDate (opens in a new tab)The date your Organization was founded in ISO 8601 date format (opens in a new tab), if applicable.
iso6523CodeText (opens in a new tab)The ISO 6523 identifier (opens in a new tab) of your organization, if applicable. The first part of an ISO 6523 identifier is an ICD (International Code Designator) which defines which identification scheme is used. The second part is the actual identifier. We recommend separating the ICD and the identifier with a colon character (U+003A). Common ICD values include:

• 0060: Dun & Bradstreet Data Universal Numbering System (DUNS (opens in a new tab))
• 0088: GS1 Global Location Number (GLN (opens in a new tab))
• 0199: Legal Entity Identifier (LEI (opens in a new tab))

Address example

You can provide multiple addresses if you have a location in multiple cities, states, or countries. Example:

"address": [{
  "@type": "PostalAddress",
  "streetAddress": "999 W Example St Suite 99 Unit 9",
  "addressLocality": "New York",
  "addressRegion": "NY",
  "postalCode": "10019",
  "addressCountry": "US"
},{
  "streetAddress": "999 Rue due exemple",
  "addressLocality": "Paris",
  "postalCode": "75001",
  "addressCountry": "FR"
}]

iso6523Code example

Example of a LEI identifier (ICD for LEI are "0199").

"iso6523Code": "0199:HWUPKR0MPOU8FGXBT394"

You can provide multiple iso6523 codes. Example:

// LEI code and DUNS number
"iso6523Code": ["0199:HWUPKR0MPOU8FGXBT394", "0060:060704780"]
IntroductionEntity