Skip to content

Website Schema Generator - JSON-LD for Site Name

Import existing JSON-LD

Paste JSON-LD or a full <script> tag. Matching fields fill the form; properties the form doesn't cover are kept in the output as they are.

Site Information

The name Google should display for your site in search results.

An abbreviation or commonly used alternative name for your site.

Search Action

Use {search_term_string} as the query placeholder.

Google Search Preview
example.com
Site Name
All Google requirements met

JSON-LD Output

What is WebSite schema?

WebSite schema is structured data that names your website as a whole. It uses the schema.org WebSite type in a JSON-LD block on your home page, giving the site's name, its home page URL, and any alternate names. Google reads it as the main signal for the site name it shows above your search results.

It describes the site, not a page, so it belongs on the home page only. Each domain or subdomain gets one site name; subfolders like /blog/ cannot have their own.

WebSite schema example (JSON-LD)

A complete example you can adapt. Paste it into the page's HTML, or build your own with the generator above.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "Kestrel Field Guides",
  "alternateName": [
    "Kestrel",
    "KFG"
  ],
  "url": "https://kestrelguides.org/",
  "publisher": {
    "@type": "Organization",
    "name": "Kestrel Field Guides Trust",
    "url": "https://kestrelguides.org/"
  }
}
</script>

Which Google rich result does it enable?

WebSite markup controls the site name shown next to your favicon at the top of each result. Without it Google guesses from your title tags, headings, and other signals, which often produces a truncated or generic name.

It no longer creates a search box. Google announced the end of the sitelinks search box in October 2024 and stopped showing it in November 2024, so SearchAction markup has no visible effect in Google. It is harmless to keep, and the generator still offers it for other consumers.

Required and recommended properties

Property Status Notes
name Required The site name you want shown. Use the name people actually call the site, and keep it consistent with your home page title and logo.
url Required The canonical home page URL of the domain or subdomain, such as https://kestrelguides.org/.
alternateName Recommended Fallback names in order of preference, such as an acronym or shorter brand. Google uses one if it can't use name.

Common WebSite schema mistakes

  • Placing WebSite markup on article or category pages. Google only reads it from the home page at the domain or subdomain root.
  • Expecting a subfolder or language path like /de/ to get its own site name. Only domains and subdomains can.
  • Using a generic name such as Home or Best Recipes Online. Google may ignore names that don't look like a real site name.
  • Different markup on the http, https, www, and non-www versions of the home page. Use identical markup on any duplicates.
  • Adding SearchAction just to get a search box. That feature has been retired.

When Google still shows the wrong name

Markup is the strongest signal, but Google checks it against the rest of your home page. If your <title>, Open Graph og:site_name, and main heading all say something different, Google may pick one of those instead. Make them agree with the name property. If Google still uses a different name, add your preferred short form as alternateName and request indexing of the home page in Search Console. Changes can take a few weeks to show.

Subdomains and multiple sites

A subdomain like shop.example.com can have its own site name by adding WebSite markup to its own home page. If it has none, Google may fall back to the name from the main domain. The www and m subdomains are treated as the same site as the root domain, so they share one name.

Related Tools

Frequently Asked Questions

What does WebSite schema do?
WebSite schema tells Google the official name of your website. Google uses this structured data to display the correct site name alongside your URLs in search results, rather than guessing from your title tags or headings.
How does WebSite schema affect my site name in Google Search?
It uses name as the first choice and alternateName as the fallback. If neither looks like a real site name, or they conflict with your home page title and og:site_name, Google may choose something else, often the domain.
Was the Sitelinks Search Box deprecated?
Yes. Google announced the change in October 2024 and stopped showing the sitelinks search box in November 2024. SearchAction markup no longer triggers a search box in Google. You can leave it in place for other consumers, but it has no visible effect.
Where should I place WebSite schema?
On the home page only. Google reads WebSite markup from the home page at the root of the domain or subdomain and ignores it elsewhere.
When should I use the alternateName property?
Use alternateName when your site is commonly known by an abbreviation, acronym, or alternate spelling. For example, if your site is 'International Business Machines' but people search for 'IBM', adding IBM as an alternateName helps Google recognise both.