Schema

Organization schema

Add Organization JSON-LD with logo, url, contact details and sameAs links so search engines and AI tools connect the site to the right company. Use when a home page has no Organization markup or the brand is confused with another company.

organization-schema/SKILL.md

Facts to use

  • Google recommends the format that is easiest to maintain, which is JSON-LD in most cases.
  • Put Organization markup on the home page or on one page about the company, such as the about page. Google lists no required properties. Recommended include: name, url, logo, sameAs, description, contactPoint, address and identifiers such as vatID or duns.
  • A logo must be at least 112 x 112 px, at a crawlable URL.
  • Markup must describe the content on the page and be true. Do not mark up content that users cannot see where Google requires it to be visible.

Workflow

  1. Collect facts from the owner and the site: legal and common name, home URL, logo URL (a square image that is crawlable), contact email or phone, address if public, official profile URLs.
  2. Write the JSON-LD and place it in the <head> or body of the home page, in the raw HTML.
  3. Use the same name, logo and URLs as the profiles listed in sameAs (see entity-consistency-sameas).
  4. Validate with the Rich Results Test and the Schema Markup Validator.

Template

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Example Co",
  "url": "https://example.com/",
  "logo": "https://example.com/logo.png",
  "email": "hello@example.com",
  "sameAs": [
    "https://www.linkedin.com/company/example-co",
    "https://x.com/exampleco",
    "https://github.com/example-co"
  ]
}
</script>

Checks

  • Valid JSON with no errors in the validators.
  • Every sameAs URL is an official profile that returns 200.
  • Only one Organization block describes the company per page.

Output

The JSON-LD block and the page where it goes.

Sources

  • Google: Organization structured data. https://developers.google.com/search/docs/appearance/structured-data/organization
  • Google: Introduction to structured data markup. https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data
  • Schema.org: Organization. https://schema.org/Organization
See all 30 skills