Schema reference

Organization schema

Who needs it: Every business, on the homepage. This is the one to add first if you add nothing else.

What it does for AI citation

It is how an assistant learns you are an entity rather than a string of words. Without it, a model has to infer who you are from prose, and it will happily confuse you with a similarly named company. The sameAs array is the part that does the disambiguating: it ties your site to profiles the model already has an entity for.

A working example

Paste this into a <script type="application/ld+json"> tag in your page head and replace the values. It is valid as written.

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Example Co",
  "url": "https://example.com",
  "logo": "https://example.com/logo.png",
  "description": "One sentence saying what you do, in the words a buyer would use.",
  "foundingDate": "2019-04-01",
  "sameAs": [
    "https://www.linkedin.com/company/example-co",
    "https://x.com/exampleco",
    "https://www.crunchbase.com/organization/example-co"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer support",
    "email": "support@example.com"
  }
}

What actually goes wrong

These are the errors that show up repeatedly on real sites, in rough order of how often we see them.

  • Leaving sameAs out. It is the field that does the disambiguation work, and it is the one most often skipped because it looks decorative.
  • A logo URL that 404s or points at an SVG. Google's guidance wants a raster image it can fetch.
  • Putting Organization on every page instead of once on the homepage, then wondering why the entity looks fragmented.
  • Using the legal entity name when every customer knows you by a trading name. Use the name people search for, and put the legal one in legalName.

Markup is necessary, not sufficient

Valid Organization does not buy you a citation. It makes your page legible, which is the precondition. Whether an assistant names you when a buyer asks also turns on your content, how current the page is, and who else on the web corroborates you. Any tool that tells you markup alone will get you cited is overselling.

Check what you have now

Before writing new markup, it is worth seeing whether assistants can reach your pages at all. The crawler checker is free and needs no sign-up.

Other types