Subscription & Paywalled Content Structured Data: Complete Implementation Guide

Why Use NewsArticle Schema?

• Prevent Google from classifying your paywall as cloaking, which could result in a manual action or removal from search results
• Maintain full indexing of your subscription content so paywalled articles continue to appear in Google Search
• Comply with Google's Flexible Sampling guidelines, giving you control over how much free content to show before the paywall triggers
• Build trust with both users and search engines by transparently communicating your content access model
• Support your publication's revenue model without sacrificing search visibility or organic traffic

Required Properties

These properties are required by Google for NewsArticle structured data to be eligible for rich results.

Recommended Properties

Adding these properties improves your chances of appearing in rich results and provides more context to search engines.

JSON-LD Example

Here is a complete NewsArticle structured data example you can use as a starting point. Or use our NewsArticle generator to create one automatically.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "NewsArticle",
  "headline": "UK Housing Market Forecast: What to Expect in 2026",
  "datePublished": "2026-03-08",
  "dateModified": "2026-03-10",
  "author": {
    "@type": "Person",
    "name": "Emma Richardson",
    "url": "https://example.com/authors/emma-richardson"
  },
  "publisher": {
    "@type": "Organization",
    "name": "The Property Gazette",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/images/logo.png"
    }
  },
  "image": "https://example.com/images/housing-market-2026.jpg",
  "description": "An in-depth analysis of UK housing market trends, mortgage rate projections, and regional price forecasts for the year ahead.",
  "isAccessibleForFree": false,
  "hasPart": [
    {
      "@type": "WebPageElement",
      "isAccessibleForFree": false,
      "cssSelector": ".paywall-content"
    }
  ]
}
</script>

How to Implement NewsArticle Schema

1. 1Identify all pages on your site that restrict content behind a paywall or subscription, including fully paywalled pages and those using metered or partial access models.
2. 2Wrap the paywalled sections of your HTML in a container element with a descriptive CSS class, such as 'paywall-content' or 'subscriber-only'.
3. 3Add a JSON-LD script block to each paywalled page using the appropriate article type (NewsArticle, Article, or BlogPosting) with the isAccessibleForFree property set to false.
4. 4For metered or partial paywalls, include the hasPart property with an array of WebPageElement objects, each specifying isAccessibleForFree: false and a cssSelector pointing to the locked content.
5. 5Ensure your server allows Googlebot to crawl the full page content — the structured data tells Google the paywall is legitimate, but Googlebot must still be able to see the content for indexing.
6. 6Validate your implementation using Google's Rich Results Test and monitor the relevant enhancement reports in Google Search Console for any errors.

Common Mistakes to Avoid

• Blocking Googlebot from accessing the paywalled content entirely — Google needs to crawl the full content to index it. The structured data only signals that user access is restricted.
• Omitting the hasPart property for metered or partially paywalled pages, which prevents Google from understanding which specific sections are restricted.
• Using incorrect cssSelector values that do not match the actual HTML elements containing the paywalled content, rendering the markup ineffective.
• Forgetting to set isAccessibleForFree to false — without this explicit signal, Google may still interpret the content restriction as cloaking.
• Applying paywalled content markup to pages that are actually freely accessible, which sends conflicting signals and may confuse search engines.

Testing & Validation

Before deploying your NewsArticle structured data, validate it using these tools:

1. 1Google Rich Results Test — Paste your page URL or code snippet to check if your structured data is eligible for rich results.
2. 2Schema Markup Validator — Validates your JSON-LD syntax against the schema.org specification.
3. 3Google Search Console — After deployment, monitor the Enhancements report for any errors or warnings.

Frequently Asked Questions