Google paywalled content structured data
The Google paywalled content markup rules,
as documented
What Google documents, in its own words. Verified from Google's page on 2026-10-09.
Google's page explains how to mark up subscription and paywalled content with CreativeWork properties. This page lists those statements with the exact wording from Google.
What Google says
| Topic | What Google says | Source |
|---|---|---|
| Purpose | “This structured data helps Google differentiate paywalled content from the practice of cloaking, which violates spam policies.” | Google docs Verified 2026-10-09 |
| Scope | “This guide only applies to content that you want crawled and indexed.” | Google docs Verified 2026-10-09 |
| Formats | “JSON-LD and microdata formats are accepted methods for specifying structured data for paywalled content.” | Google docs Verified 2026-10-09 |
| Nesting | “Don't nest content sections.” | Google docs Verified 2026-10-09 |
| Selectors | “Only use .class selectors for the cssSelector property.” | Google docs Verified 2026-10-09 |
| Implementation | “If you don't want the content to be accessible to the browser at the time of serving, choose a paywall implementation that doesn't supply the paywalled content to the browser.” | Google docs Verified 2026-10-09 |
| isAccessibleForFree | “Set the isAccessibleForFree property to false to specify that this section is behind a paywall.”Required property. | Google docs Verified 2026-10-09 |
| Multiple sections | “If you have multiple paywalled sections on a page, add the class names as an array.” | Google docs Verified 2026-10-09 |
| Supported types | “This markup is supported for the CreativeWork type or one of the following more specific types of CreativeWork:”Google lists Article, NewsArticle, Blog, Comment, Course, HowTo, Message, Review and WebPage. | Google docs Verified 2026-10-09 |
| Violations | “If you violate these policies, your page might not be eligible to be displayed in Search results.” | Google docs Verified 2026-10-09 |
| Crawl access | “If you want Google to crawl and index your content, including the paywalled sections, make sure Googlebot, and Googlebot-News if applicable, can access your page.” | Google docs Verified 2026-10-09 |
| Snippets | “To exclude certain sections of your content from appearing in search result snippets, use the data-nosnippet HTML attribute.” | Google docs Verified 2026-10-09 |
| AMP | “Ensure that your bot access policy is the same for AMP and non-AMP pages, otherwise this can result in content mismatch errors that appear in Search Console.” | Google docs Verified 2026-10-09 |
How to apply it
A checklist built only from the guidance in Google's page.
- Add a class name around each paywalled section of the page.
- Add isAccessibleForFree set to false, and hasPart with a WebPageElement and the .class cssSelector.
- For several sections, list the class names as an array.
- Do not nest content sections, and use only .class selectors.
- Validate with the Rich Results Test and make sure Googlebot can access the page.
Questions
Which property is required for paywalled content?
Google lists isAccessibleForFree, set to false for the paywalled section.
How do I mark which part of the page is paywalled?
Google says to add a class name around each paywalled section and reference it with hasPart.cssSelector, using only .class selectors.
Can a page have several paywalled sections?
Yes. Google says to add the class names as an array.
Does the markup apply to content I do not want indexed?
No. Google says the guide only applies to content that you want crawled and indexed.
Which types support the markup?
CreativeWork and more specific types such as Article, NewsArticle, Blog, Course, HowTo and WebPage.
How current is this page?
Every quote was read from Google's page on 2026-10-09. The page showed "Last updated 2026-09-08 UTC". Google can change its documentation, so treat the linked page as the final word.
Sources
- Subscription and paywalled content structured data (Google Search Central), read on 2026-10-09
Let Balzac write the articles.
Type your website. Balzac finds the searches you can win, writes articles built to rank on Google and get cited by ChatGPT, and publishes them for you.
3 free articles · No card needed