Organization

Organization covers companies, non-profits, government bodies, and any other named group. It's one of the most-used schema types on the web because almost every site has an "about" or "contact" page with an organization on it.

If your entity is more specific than a generic organization, reach for a subtype. Universities should use CollegeOrUniversity, clinics should use MedicalOrganization, public companies should use Corporation, non-profits should use NGO. The EducationalOrganization example covers that decision in depth.

Full example of schema.org/Organization json-ld markup

The markup is verified as valid with Rich Results Test from Google.

Highlight legend:Required by GoogleRecommendedOptional

schema.org/Organization

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@id": "https://xoocode.com#organization",
  "@type": "Organization",
  "name": "Xoo Code Inc.",
  "url": "https://xoocode.com",
  "legalName": "Xoo Code House Incorporated",
  "leiCode": "549300TGFLH2QZV80T70",
  "naics": "561499",
  "duns": "739010039",
  "taxID": "44-9008710",
  "vatID": "902019881001",
  "email": "info@xoocode.com",
  "description": "XooCode is a company based in Vancouver Canada that codes and sells applications.",
  "alternateName": [
    "XooCode",
    "Xoo"
  ],
  "mainEntityOfPage": "https://techcrunch.com/news/xoo-code-funding-round-2",
  "sameAs": "https://wikipedia.org/organization/xoo-code-inc",
  "logo": "https://xoocode.com/images/xoo-code-company-logo.jpg",
  "image": [
    "https://xoocode.com/images/xoo-code-company-image-1.jpg",
    "https://xoocode.com/images/xoo-code-company-image-2.jpg",
    "https://xoocode.com/images/xoo-portrait-of-a-company.jpg"
  ],
  "alumni": "Jane Xoo",
  "award": "Rising Code Stars 2016",
  "brand": [
    "XooTee",
    "XooShoes",
    "XooPremium"
  ],
  "address": {
    "@type": "PostalAddress",
    "addressLocality": "Vancouver",
    "postalCode": "T1B 0K2",
    "streetAddress": "12 Paray Road"
  },
  "contactPoint": {
    "contactType": "PR",
    "email": "presscore@xoocode.com",
    "telephone": "+15556009212",
    "productSupported": "XooPremium",
    "hoursAvailable": [
      "Mo-Fri 08:00-20:00",
      "Sa-Su 10:00-18:00"
    ],
    "url": "https://xoocode.com/press"
  },
  "founder": "Jim Xoo",
  "foundingDate": "1904-08-10",
  "numberOfEmployees": "240",
  "seeks": "Fame"
}
</script>

Rich result preview

Approximate preview of what Google may render from this markup. Hover any element inside the card to see which JSON-LD path produced it. Google decides whether to show any rich result. Markup makes you eligible, not guaranteed.

google.com/search?q=xoo%20code%20inc.

(logo)

Xoo Code Inc.

xoocode.com

XooCode is a company based in Vancouver Canada that codes and sells applications.

Minimal valid version

The smallest markup that still produces a valid Organization entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/Organization (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Xoo Code Inc.",
  "url": "https://xoocode.com",
  "logo": "https://xoocode.com/images/xoo-code-company-logo.jpg"
}
</script>

Google rich results this unlocks

Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.

Organization logo in Google Searchprimary
Google docs
Knowledge Panel enrichment
Google docs

Common Organization mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

01
Logo as a raw URL instead of an ImageObject
Wrong
```
"logo": "https://xoocode.com/images/xoo-code-company-logo.jpg"
```
Right
```
"logo": {
  "@type": "ImageObject",
  "url": "https://xoocode.com/images/xoo-code-company-logo.jpg",
  "width": "512",
  "height": "512"
}
```
A raw URL validates and Google will accept it, but the ImageObject form lets you communicate dimensions. Google's logo requirements state the image should be at least 112x112 px on a square canvas with the brand mark clearly visible.
02
contactPoint without a valid contactType
Wrong
```
"contactPoint": { "email": "info@xoocode.com" }
```
Right
```
"contactPoint": {
  "@type": "ContactPoint",
  "contactType": "customer service",
  "email": "info@xoocode.com",
  "areaServed": "CA"
}
```
Google expects contactType to be one of the documented enum values (customer service, technical support, billing support, sales, etc.). Missing contactType is a frequent reason Organization markup fails to surface in Search.
03
No stable @id across pages
Wrong
```
Each page marking up the same Organization with a different @id (or no @id)
```
Right
```
Pick one @id (e.g. "https://xoocode.com#organization") and reuse it on every page via { "@id": "https://xoocode.com#organization" }
```
Without a stable @id, Google treats each reference as a separate entity. A shared @id is the mechanism that lets search engines merge facts about the same organization from multiple pages into one Knowledge Graph node.

Schema properties in this example

Also mentioned in 92 other examples

Organization also appears in 3DModel, AboutPage, AdvertiserContentArticle, AmpStory, AmusementPark, AnalysisNewsArticle, APIReference, AskPublicNewsArticle, and 84 more. See the full Organization schema page for every reference.

About the example data

The example is Xoo Code Inc., a fictional Canadian software company that runs throughout the Xoo universe. You'll see it referenced by @id from Product (as the brand), SoftwareApplication (as the publisher), JobPosting (as the hiring organization), and a few others. It follows schema.org/Organization and serves as one of two main anchor entities on the site, alongside LocalBusiness for the Dunmore store.

Comments

Loading comments...