Organization and WebSite schema: JSON-LD templates you can copy for your home page
Put one JSON-LD block on your home page that describes two things: your company (Organization, or a more specific type such as LocalBusiness or OnlineStore) and your website (WebSite). Fill in your real name, URL, logo, contact details and official profiles, keep it in the page's HTML rather than injecting it later, and check it with the Schema Markup Validator. Copy the templates below and swap in your details.

- No required properties: Google's Organization documentation says there are "no required properties" and recommends adding as many relevant ones as apply to your organisation.
- Home page is enough: Google recommends putting Organization markup on your home page or one page that describes your organisation, and says you don't need it on every page.
- WebSite sets your site name: Google says WebSite structured data on the home page is the most important signal if you want to state a preference for the site name shown in search results. It needs only
nameandurl. - No special schema for AI features: Google says there's "no special schema.org structured data" you need to add to appear in AI Overviews or AI Mode, but your structured data should match the visible text on the page.
- Many AI crawlers don't run JavaScript: Vercel's December 2024 analysis found that OpenAI's, Anthropic's, Meta's, ByteDance's and Perplexity's crawlers did not render JavaScript, so markup added only by a script may never reach them.
- Sitelinks search box is gone: Google stopped showing the sitelinks search box in November 2024. You don't need a
SearchActionfor it, though Google says leaving old markup in place causes no errors.
What do Organization and WebSite schema actually do?
Structured data is a small block of code that states facts about a page in a fixed vocabulary (schema.org), so software doesn't have to guess them from your design. Two types belong on almost every home page.
| Type | What it describes | Where it goes | What Google says it's for |
|---|---|---|---|
Organization (or a subtype) |
The business behind the site: name, logo, address, contact details, official profiles, company IDs | Home page or About page, once | Understanding your administrative details, telling you apart from similarly named organisations, and choosing the logo for results and knowledge panels |
WebSite |
The website itself: its name, other names and home page URL | Home page only | Your preferred site name in Google Search results |
For AI assistants the value is the same as for search engines: an unambiguous, machine-readable statement of who you are, what your official name is and which profiles are really yours. That matters most when your name is shared with another company, which is one of the causes we covered in ChatGPT gets facts about my business wrong.
Be honest with yourself about the limits. Google says this markup can help it understand your organisation. It doesn't promise a knowledge panel, a citation or a ranking boost, and none of the main AI assistants has published rules on how much weight it gives schema.org markup.
Template 1: a company or service business
This is the version most sites need. It describes the company and the website in one block, and links them with @id values so they read as one connected set of facts instead of two unrelated ones.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Organization",
"@id": "https://www.example.com/#organization",
"name": "Example Studio",
"alternateName": "ExStudio",
"legalName": "Example Studio, Lda.",
"url": "https://www.example.com/",
"logo": "https://www.example.com/images/logo.png",
"description": "Example Studio designs websites and online shops for small businesses in Portugal and Spain.",
"email": "hello@example.com",
"telephone": "+351-210-000-000",
"address": {
"@type": "PostalAddress",
"streetAddress": "Rua Exemplo 10",
"addressLocality": "Lisboa",
"postalCode": "1000-001",
"addressCountry": "PT"
},
"sameAs": [
"https://www.linkedin.com/company/example-studio",
"https://www.instagram.com/examplestudio"
]
},
{
"@type": "WebSite",
"@id": "https://www.example.com/#website",
"name": "Example Studio",
"alternateName": "ExStudio",
"url": "https://www.example.com/",
"publisher": { "@id": "https://www.example.com/#organization" }
}
]
}
</script>
Delete any line you can't fill in truthfully. An empty or invented value is worse than a missing one: Google's introduction to structured data says it's more important to supply fewer but complete and accurate recommended properties than every possible property with badly formed or inaccurate data.
For reference, our own home page at web2agents.com uses this same pattern: an Organization node with name, URL, logo, description and a customer support contactPoint, plus a WebSite node that points back to it as publisher.
Template 2: a local business with a shop, office or restaurant
If customers visit you, Google recommends using the most specific LocalBusiness subtype that fits (for example Restaurant, Dentist or HardwareStore) and following its Local business guidelines. For that type, name and address are required.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Restaurant",
"@id": "https://www.example.com/#organization",
"name": "Tasca Exemplo",
"url": "https://www.example.com/",
"logo": "https://www.example.com/images/logo.png",
"image": "https://www.example.com/images/dining-room.jpg",
"telephone": "+351-210-000-000",
"priceRange": "€€",
"servesCuisine": "Portuguese",
"menu": "https://www.example.com/menu",
"address": {
"@type": "PostalAddress",
"streetAddress": "Rua Exemplo 10",
"addressLocality": "Lisboa",
"postalCode": "1000-001",
"addressCountry": "PT"
},
"geo": {
"@type": "GeoCoordinates",
"latitude": 38.71234,
"longitude": -9.13987
},
"openingHoursSpecification": [
{
"@type": "OpeningHoursSpecification",
"dayOfWeek": ["Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"],
"opens": "12:00:00",
"closes": "23:00:00"
}
],
"sameAs": ["https://www.instagram.com/tascaexemplo"]
},
{
"@type": "WebSite",
"@id": "https://www.example.com/#website",
"name": "Tasca Exemplo",
"url": "https://www.example.com/",
"publisher": { "@id": "https://www.example.com/#organization" }
}
]
}
</script>
Google asks for at least five decimal places on latitude and longitude, times in hh:mm:ss format, and a priceRange under 100 characters. Use exactly the same name, address and phone number as on your Google Business Profile and on your contact page.
Template 3: an online store
For an e-commerce site, Google recommends the OnlineStore subtype rather than the more general OnlineBusiness. Add a customer service contactPoint so shoppers and assistants can find the right channel.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "OnlineStore",
"@id": "https://www.example.com/#organization",
"name": "Example Shop",
"url": "https://www.example.com/",
"logo": "https://www.example.com/images/logo.png",
"description": "Handmade ceramics shipped from Porto to Portugal, Spain and France.",
"vatID": "PT500000000",
"contactPoint": {
"@type": "ContactPoint",
"contactType": "Customer Service",
"email": "support@example.com",
"telephone": "+351-220-000-000"
},
"sameAs": ["https://www.instagram.com/exampleshop"]
},
{
"@type": "WebSite",
"@id": "https://www.example.com/#website",
"name": "Example Shop",
"url": "https://www.example.com/",
"publisher": { "@id": "https://www.example.com/#organization" }
}
]
}
</script>
Google's documentation also lets an online store add its standard shipping policy (hasShippingService) and return policy (hasMerchantReturnPolicy) at this level. We walk through both, with templates, in How do you show your shipping costs and return policy to Google and AI shopping assistants?.
Which properties matter most?
Google suggests focusing on properties that are useful to people: your name, signs of a real-world presence (address or phone) and signs of an online presence (URL or logo).
| Property | What to put | Tip |
|---|---|---|
name |
The name customers know you by | Same name in WebSite, your page title and your headings |
alternateName |
An acronym or short name | Optional; list several in order of preference |
legalName |
Your registered company name | Only if it differs from name |
url |
Your canonical home page | Pick www or non-www and use it everywhere |
logo |
A crawlable image URL | At least 112x112 px and readable on a white background |
address |
Street, city, postcode, country | Two-letter ISO country code, such as PT or ES |
telephone / email |
Your main customer contact | Include the country code in phone numbers |
sameAs |
Your official profiles on other sites | Only profiles you control; it's how you claim them |
vatID / taxID |
Your VAT or tax number | Google calls a VAT number an important trust signal |
description |
One or two plain sentences on what you do | Say the same thing your home page says |
Where do you paste it?
Put the block in the <head> of your home page, or in the body if your platform only allows that. Google reads JSON-LD in either place.
Before you paste anything, check whether your theme, SEO plugin or website builder already outputs Organization or WebSite markup. Two competing Organization blocks with different names or logos send mixed signals, and Google asks you to avoid creating an extra WebSite block on the home page if one already exists. Add your details to the existing one instead.
Platform steps are in our guides for Webflow, WordPress, Shopify, Wix and Squarespace.
One technical point matters more for AI than for Google. Google can read JSON-LD that JavaScript injects into the page, for example through a tag manager. But Vercel's analysis of AI crawler traffic found that none of the major AI crawlers it tested rendered JavaScript, including OpenAI's, Anthropic's and Perplexity's. If you want those crawlers to see your markup, it needs to be in the HTML your server sends. Check by opening your home page with "View page source" and searching for application/ld+json.
Does schema get you cited by ChatGPT or AI Overviews?
Not on its own. Google's guide to AI features and your website says there are no extra requirements for AI Overviews or AI Mode and "no special schema.org structured data that you need to add". The same page lists, among ordinary SEO best practices, making sure your structured data matches the visible text on the page.
So treat Organization and WebSite markup as identity hygiene, not a ranking trick. It states your name, logo, contact details and official profiles clearly, in one place, for any system that reads it. What gets you cited is still a page that answers the question well, can be crawled and is consistent with what the rest of the web says about you. Our checklist for getting cited by ChatGPT covers the rest.
Common mistakes
| Mistake | Why it's a problem | Fix |
|---|---|---|
| Copying the template with placeholder values left in | Your markup now describes "Example Studio" | Search the block for example before publishing |
| Different names in markup, title and footer | Google says the site name should be consistent across your home page | Pick one name and use it everywhere |
| Star ratings for your own business | Google recommends aggregateRating in LocalBusiness only for sites that collect reviews about other businesses |
Remove self-review ratings from your own business markup |
| Facts that aren't on the page | Google's guidelines say markup must represent the page's main content and not describe hidden content | Show the address, phone and hours as text too |
| Markup added only via JavaScript | Many AI crawlers don't execute scripts | Output the JSON-LD in the server HTML |
| Two Organization or WebSite blocks | Conflicting signals | Merge into one, or edit the one your plugin creates |
A SearchAction added just for the search box |
Google retired the sitelinks search box in 2024 | Optional to remove; it causes no errors |
sameAs pointing to profiles you don't own |
You're claiming someone else's identity | List only official profiles you control |
How to test it
- Check the syntax with the Schema Markup Validator. Paste your URL or the code and fix anything flagged as an error.
- Check Google's view with the Rich Results Test for Organization and LocalBusiness properties. Google notes that site names aren't supported in the Rich Results Test, so rely on the validator for the
WebSiteblock. - Inspect the live page with the URL Inspection tool in Search Console, make sure the home page isn't blocked by robots.txt,
noindexor a login, and request a recrawl. - Wait. Google says it can take from a few days to a few weeks for changes such as a new site name to be picked up.
Check your site
Want to know whether your home page already has valid Organization and WebSite markup, and whether AI crawlers can reach it? Run the free Web2Agents AI check. If you'd rather not write the code yourself, the €19 AI-Ready Kit includes paste-ready Organization, WebSite and per-page schema blocks written for your site, with install steps for Webflow, WordPress, Shopify, Wix and Squarespace.
More on this topic: Structured data for AI.
FAQ
Do I need Organization schema on every page?
No. Google recommends putting Organization markup on your home page or on one page that describes your organisation, such as your About page, and says you don't need to include it on every page.
What's the difference between Organization and WebSite schema?
Organization describes the business: its name, logo, address, contact details and official profiles. WebSite describes the site itself and is what Google uses to understand your preferred site name. Most home pages should have both, linked with @id values.
Should I use Organization or LocalBusiness?
Use the most specific type that fits. Google recommends a LocalBusiness subtype, such as Restaurant or Dentist, if customers visit a physical location, OnlineStore for an e-commerce site, and plain Organization for other companies.
Will this markup get my business into ChatGPT or AI Overviews?
Not by itself. Google says there's no special schema.org markup needed to appear in AI Overviews or AI Mode. The markup states your company facts clearly, but citations still depend on useful, crawlable content and consistent information across the web.
Does Google still support the sitelinks search box markup?
No. Google stopped showing the sitelinks search box in November 2024. You can leave existing SearchAction markup in place, as Google says it won't cause errors, but there's no reason to add it now.
Sources
- Organization structured data, Google Search Central
- Provide a site name to Google Search, Google Search Central
- Local business structured data, Google Search Central
- AI features and your website, Google Search Central
- Introduction to structured data markup in Google Search, Google Search Central
- General structured data guidelines, Google Search Central
- Farewell, Sitelinks Search Box, Google Search Central Blog, 21 October 2024
- Organization, schema.org
- The rise of the AI crawler, Vercel, 17 December 2024


















