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
- 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.
- Write the JSON-LD and place it in the
<head>or body of the home page, in the raw HTML. - Use the same name, logo and URLs as the profiles listed in
sameAs(see entity-consistency-sameas). - 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