Import existing JSON-LD(paste code or read it from a URL)
Paste WebPage JSON-LD (or a subtype such as ItemPage). A WebSite node in the same @graph turns on the WebSite block.
Basic page details
Topics: about and mentions (optional)
One entity per line as Name | URL. Use a Wikipedia or Wikidata URL so the topic is unambiguous. It is written as a Thing with sameAs.
Publisher / organization (optional)
Author (optional)
Breadcrumb (optional, 3 levels)
Level 1 links to the site root and the last level to the page URL. Enter the level 2 URL yourself when you use three levels.
Speakable, keywords & key links (optional)
Speakable is a Google beta for news publishers in English in the US. It marks the parts of a page that suit text-to-speech. It does no harm elsewhere.
- WebPageMissing required name or headline.
- WebPageRecommended: add url.
- WebPageRecommended: add description.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebPage",
"breadcrumb": {
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home"
}
]
}
}
</script>How to use
Pick a type and auto-fill
Choose the page type, paste the URL and press Auto-fill from URL. Check the title, URL, description, image, language and dates; the description counter warns past 160 characters.
Add topics and site details
List the main topic under about and other entities under mentions as Name | URL lines. Tick Add a WebSite block and enter the site name if this is your homepage.
Publisher, author, breadcrumb, copy
Fill publisher and author, then up to three breadcrumb levels, entering the level 2 URL yourself. Check the Validation panel, press Copy script and use the test links.
Why WebPage Schema Generator
- Eleven WebPage types in one form, pre-filled from a URL or pasted JSON-LD.
- about and mentions entities with Wikipedia or Wikidata URLs.
- Optional WebSite block linked with isPartOf.
- Speakable, keywords, lastReviewed and significantLink fields.
WebPage, WebSite or Article: when to use each
These types describe different levels of a site. Choosing the right one avoids two blocks that disagree.
One page can carry more than one of them when they are linked. A homepage often has WebSite and WebPage in one @graph, and a blog post has an Article that is part of the WebSite. What to avoid is two unlinked blocks that both describe the same page.
| Type | Describes | Typical page | Google use |
|---|---|---|---|
| WebSite | The whole site | Homepage | Site name in results |
| WebPage | One page with no more specific type | Pricing, legal, landing pages | No rich result of its own |
| Article or BlogPosting | A written piece with author and date | Blog posts, news, guides | Article results |
| WebPage subtype | A page with a clear role | AboutPage, ContactPage, CollectionPage | No rich result of its own |
Example: a pricing page with a breadcrumb
A SaaS pricing page at example.com/pricing/ has the type WebPage, name Pricing, a description, language en, publisher Example Ltd with its logo, and about set to Software as a service with its Wikipedia URL. Tick Add a WebSite block with site name Example.
The output is an @graph. The WebPage node has an @id ending in #webpage, isPartOf pointing to example.com/#website, the about Thing, and a BreadcrumbList with Home linking to the root and Pricing linking to the page. The WebSite node holds the site name, URL, language and publisher.
Without the WebSite block, the same data is written as a single WebPage with the publisher nested inside. Add the WebSite block on the homepage at least, since that is where Google reads the site name.
Common questions
When is plain WebPage schema worth adding?
What are about and mentions in WebPage schema?
What is the difference between WebPage and WebSite schema?
Does WebSite schema still give a sitelinks search box?
Which page types does the webpage schema generator include?
How does the WebPage tool build breadcrumb item URLs?
Can the author in WebPage markup be a company?
Is WebPage schema redundant if the page has Article markup?
Why is the publisher logo in WebPage markup an ImageObject?
What is speakable in WebPage schema?
More Schema tools
View allAutomatic Schema Markup Generator
Crawl your site, auto-detect + generate JSON-LD for every page
Schema Markup Generator
JSON-LD or microdata for 10 types, plus a validator
FAQ Schema Generator
Build FAQPage JSON-LD by hand, paste or URL import
Article Schema Generator
Build Article, BlogPosting or NewsArticle JSON-LD