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

TopicWhat Google saysSource
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

Read on 2026-10-09. Google's page showed "Last updated 2026-09-08 UTC". Notes under a quote are close paraphrases of the same page. This page covers only what Google documents.

How to apply it

A checklist built only from the guidance in Google's page.

  1. Add a class name around each paywalled section of the page.
  2. Add isAccessibleForFree set to false, and hasPart with a WebPageElement and the .class cssSelector.
  3. For several sections, list the class names as an array.
  4. Do not nest content sections, and use only .class selectors.
  5. Validate with the Rich Results Test and make sure Googlebot can access the page.

Related: Google Article structured data, Google spam policies, Google JavaScript SEO basics.

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

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