- Organization schema goes on your homepage and About page only, not every page. Duplicating it sitewide signals conflicting entity definitions to Google.
- Pick the most specific subtype that applies.
OnlineStorebeatsOrganizationfor ecommerce;RestaurantbeatsLocalBusinessfor restaurants. - sameAs links are the entity-disambiguation signal for Knowledge Graph and LLMs. Include Wikipedia, Wikidata, LinkedIn, X/Twitter, Crunchbase, and every other canonical profile.
- There are no strictly required properties per Google. The actual mistake is shipping too few: name, url, logo, sameAs, contactPoint, and address are the practical floor.
- Validate at validator.schema.org and the Rich Results Test before deploying. They catch different categories of errors.
Chapter 1. Before you start
Organization schema is the entity record for your brand. It tells search engines and LLMs
who you are, where you are, how to reach you, and which other profiles on the web belong to
the same entity. It powers Knowledge Panels, populates the brand-info pane in AI Overviews,
and is the foundation every other schema on your site references via
publisher or provider.
- Confirm your canonical brand name and legal name. They are often different. Use the commercial name in
nameand the legal name inlegalName. - Locate your high-resolution logo as a publicly accessible URL. Minimum 112x112 pixels. Square or rectangle, both fine. PNG with transparency is the standard.
- Gather every canonical profile URL: Wikipedia, Wikidata, LinkedIn, X/Twitter, Crunchbase, Instagram, YouTube, Facebook, and any industry profile (G2, Trustpilot, BBB).
- Confirm your registered business address. Required for LocalBusiness subtypes; recommended even for online-only brands as a Trust signal.
- Pick a contact email and phone. They go into
contactPointand surface in some search features. Use the customer-facing channels, not internal ones.
sameAs entries
linking the brand to its public profiles - which means Google could not disambiguate the
brand from same-named competitors and LLMs had no signal to associate the brand entity
with its own social presence.
Chapter 2. Pick the right subtype
Use the most specific subtype that applies. Google's structured data
policies explicitly call this out: OnlineStore beats Organization
for ecommerce; Restaurant beats LocalBusiness for restaurants;
NewsMediaOrganization beats Organization for publishers. The
specific subtype unlocks property fields the parent type does not have.
| If you are... | Use this subtype | Unlocks |
|---|---|---|
| An ecommerce store | OnlineStore | Return policy, shipping service, loyalty program fields |
| A physical-location business | LocalBusiness or specific subtype | geo, openingHoursSpecification, priceRange |
| A restaurant | Restaurant | servesCuisine, menu, acceptsReservations |
| A news publisher | NewsMediaOrganization | masthead, missionCoveragePrioritiesPolicy, diversityPolicy |
| A SaaS / online service | OnlineBusiness | General online-business signals without ecommerce constraints |
| A medical org | MedicalOrganization or Hospital | medicalSpecialty, healthPlanNetworkId |
| None of the above | Organization | Base type, all common properties |
The full subtype hierarchy is at schema.org/Organization. When in doubt, browse from the parent type down through the more specific children until you find the one that matches what your business actually is.
Chapter 3. Required and recommended properties
Google's documentation states there are no strictly required properties for Organization schema. Instead, the recommendation is to ship as many recommended properties as apply to your business. The practical floor below is what we ship on every client deployment.
{
"@context": "https://schema.org",
"@type": "OnlineStore",
"@id": "https://www.example.com/#organization",
"name": "Example Brand",
"legalName": "Example Brand, Inc.",
"url": "https://www.example.com",
"logo": "https://www.example.com/brand/logo.png",
"description": "One-sentence brand description.",
"foundingDate": "2019",
"sameAs": [
"https://en.wikipedia.org/wiki/Example_Brand",
"https://www.wikidata.org/wiki/Q12345678",
"https://www.linkedin.com/company/example-brand",
"https://x.com/examplebrand",
"https://www.crunchbase.com/organization/example-brand"
],
"contactPoint": {
"@type": "ContactPoint",
"contactType": "Customer Service",
"email": "support@example.com",
"telephone": "+1-555-123-4567"
},
"address": {
"@type": "PostalAddress",
"streetAddress": "1 Main St",
"addressLocality": "Anytown",
"addressRegion": "CA",
"postalCode": "94000",
"addressCountry": "US"
}
}
Each field above is recommended by Google. For full subtype-specific fields (e.g.
hasMerchantReturnPolicy, hasShippingService, and
hasMemberProgram on OnlineStore), see the Search Central
Organization
documentation.
Chapter 4. Which sameAs links matter most?
sameAs is the single most under-shipped Organization property and the highest-leverage
one for AI search visibility. Every URL you list in sameAs reinforces
the entity record - Knowledge Graph uses them for disambiguation, LLMs use them to tighten
the entity embedding in vector space.
| Profile | Why it matters | Priority |
|---|---|---|
| Wikipedia article | Largest single training source for every major LLM | Highest |
| Wikidata entity (Q-number) | Canonical entity database Google's KG syncs with | Highest |
| LinkedIn company page | Business identity verification, B2B signal | High |
| X / Twitter | Active social presence, freshness signal | High |
| Crunchbase | Funding + leadership context | Medium |
| Instagram, YouTube, TikTok, Facebook | Channel-specific brand presence | Medium |
| G2, Trustpilot, BBB, Yelp | Third-party reputation signal | Medium |
| GitHub (if applicable) | Open-source brand presence | Low-Medium |
If your brand does not have a Wikipedia or Wikidata entry yet, building one is the highest single-action lift available for AI-engine visibility. Wikipedia accounts for roughly 53% of the top-1,000 ChatGPT-cited pages and is the most cited domain in Google AI Overviews. Wikidata is the backbone Google Knowledge Graph queries for entity disambiguation.
Chapter 5. Validate before you deploy
Two validators, two purposes. Run both before you deploy a single change to production.
- Paste your JSON-LD into validator.schema.org. This validates against the Schema.org vocabulary itself - it tells you if your types and properties exist and are used correctly.
- Paste the same code into the Google Rich Results Test. This validates against Google's specific requirements for rich result eligibility - which can differ from Schema.org's general vocabulary.
- Fix every critical error from both. Non-critical warnings are worth fixing but not blocking.
- Once live, monitor Search Console → Enhancements for the Organization rich result report to catch errors at scale across your site.
Chapter 6. Where do you place Organization schema on the site?
Organization schema goes on your homepage and About page only. Not every page. Shipping it sitewide is a common Yoast / Rank Math plugin default that creates duplicate entity definitions Google has to reconcile - the opposite of what schema is for.
On the homepage, embed the JSON-LD inside <script type="application/ld+json">
tags in <head> or before </body>. Either location
works; head is conventional. On the About page, ship the same Organization
block plus any About-specific schema (founders as Person entries, history as Event entries,
etc.).
Use the @id property to give your Organization a stable identifier
(https://www.example.com/#organization is the convention). Other schemas
across your site reference this @id via publisher or
provider - which lets you ship the full Organization details once and
reference them everywhere else without duplication. See post #1, the
GA4 setup
guide, for an example of the @id reference pattern in BlogPosting schema.
Chapter 7. The breakages we see most often
Ranked by frequency across 47 ecommerce schema audits over the past 24 months:
- No sameAs entries: brand entity can't be disambiguated from same-named competitors. 31 of 47 audited stores.
- Base
Organizationtype used when a subtype exists:OnlineStoreor specificLocalBusinesssubtype is correct. 26 of 47. - Schema duplicated sitewide instead of homepage + About only: conflicting entity definitions. 22 of 47.
- Self-serving
aggregateRatingorreviewon the org's own page: Google policy violation. 17 of 47. - Logo URL returns a small or non-existent image: rich result eligibility broken. 14 of 47.
- No
@idon the Organization: other schema can't reference it cleanly. 9 of 47. - Microdata or RDFa used instead of JSON-LD: harder to maintain, Google's recommended format is JSON-LD. 6 of 47.
We track Organization schema completeness continuously through our Sentry product; the structured-data rule set catches the breakages above on running sites.
FAQ
Do I need Organization schema if my site is small?
Yes. Organization schema is the entity record for your brand and is the foundation other
schemas (Article, Product, Review) reference via publisher. Even a 10-page
site benefits because Knowledge Graph eligibility and AI-engine entity matching depend
on it. The setup takes 30 minutes and never has to change unless your business does.
Should I add Organization schema to every page or just the homepage?
Homepage and About page only. Shipping it on every page creates duplicate entity
definitions Google has to reconcile. Use @id on the homepage Organization
and reference it via publisher in other schemas to centralize the truth.
How many sameAs links should I include?
As many canonical profiles as exist. There is no upper limit. Aim for at least Wikipedia, Wikidata, LinkedIn, X/Twitter, and your two most-active social profiles. Each additional link tightens the entity disambiguation. Avoid linking to non-canonical sources (random mentions, irrelevant directories) - those dilute the signal.
Can I ship Organization schema without a Wikipedia article?
Yes. Wikipedia is recommended but not required. If your brand doesn't have one, ship the other sameAs entries and consider whether you have a defensible case for a Wikipedia article (independent press coverage, notable founders, significant industry presence). Wikipedia + Wikidata together are the highest-leverage entity signals available.
What's the difference between Organization and LocalBusiness?
LocalBusiness is a subtype of Organization for businesses with
physical locations. Use LocalBusiness (or a more specific subtype like
Restaurant, Dentist, HealthClub) for each physical
location. Use Organization or OnlineStore for online-only
businesses or for the parent corporate entity above multiple locations.
Can I include aggregateRating on my own Organization schema?
No. Google's structured data policy prohibits self-serving review markup. Only sites
reviewing OTHER businesses can ship aggregateRating or review
on Organization or LocalBusiness. Adding it to your own org's
page can trigger a manual action that strips rich result eligibility from the entire site.
References
- Schema.org. "Organization." schema.org/Organization
- Google Search Central. "Organization (Organization) structured data." developers.google.com/search/docs/appearance/structured-data/organization
- Google Search Central. "Structured data general guidelines." developers.google.com/search/docs/appearance/structured-data/sd-policies
- Google Search Central. "Search gallery of structured data." developers.google.com/search/docs/appearance/structured-data/search-gallery
- Schema.org. "Schema Markup Validator." validator.schema.org
- Google. "Rich Results Test." search.google.com/test/rich-results