WebSite schema markup is structured data that describes your website as a whole: its name, its address, its language and who publishes it. It belongs on the home page, and it helps search engines understand which site your pages come from and which name to display for it.
How to use the WebSite schema generator
Open the generator in a desktop browser with a free account and complete these steps:
- Enter the name of the site as you want it to appear in search results.
- Add an alternate name if people also know the site by a shorter or different name.
- Type the exact home page address, including https and the trailing slash if you use one.
- Choose the main language of the site.
- Set the publisher by referencing your Organization or Person schema.
- Generate the code, validate it and paste it into the head of your home page.
What WebSite schema does and does not do
WebSite markup does not make a site rank higher, and it does not create star ratings or event listings, which come from other types. Its main use is to declare the site name and the home page, which Google can use to show the site name in results. Google has also retired the sitelinks search box feature, so the old SearchAction snippet is no longer needed for that purpose.
- name and alternateName: how the site is called.
- url: the canonical address of the home page.
- inLanguage: the language of the content.
- publisher: the entity responsible for the site.
Example of WebSite JSON-LD
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebSite",
"@id": "https://www.example.com/#website",
"name": "Example Studio",
"alternateName": "Example",
"url": "https://www.example.com/",
"inLanguage": "en",
"publisher": { "@id": "https://www.example.com/#organization" }
}
</script>
Common mistakes to avoid
- Adding WebSite markup to inner pages instead of only the home page.
- Using an address that redirects, such as the version without www when the site uses www.
- Choosing a site name that differs from the name in the page title and the logo.
- Publishing several WebSite blocks with different names on the same site.
Frequently asked questions
Which schemas should I create first?
Start with Organization or Person, then WebSite, then the types that fit your pages. Our guide on the most important schema.org types explains the order.
Can I combine WebSite and Organization?
Yes, and you should. Set the publisher of the WebSite to the identifier of your Organization schema.
Does the URL slug affect the markup?
The markup uses your canonical home page address. For inner pages, clean addresses help as explained in the importance of slugs for SEO.