Stack

Publisher Schema Stack

NewsArticle + Breadcrumb + Speakable + SubscriptionAndPaywall signals for publisher pages that need clarity, eligibility, and access control.

Open generator Validate in Rich Results Test

When to use this stack

News or longform articles with metered or hard paywalls
Publisher sections that need breadcrumb clarity and speakable selectors
Articles where eligibility and access signals reduce paywall confusion

What's included

News Article
Open generator
Primary article entity with headline, dates, author, and publisher.
Breadcrumb
Open generator
Clarifies article location within the site structure.
Speakable
Open generator
Defines speakable sections for voice surfaces.
Subscription and Paywall
Open generator
Marks paywall accessibility and paywalled sections for Google guidance.

Required properties (stack union)

Ensure every applicable required property is present in your implementation. Nested props reference their parent objects (for example, `offers.priceCurrency`).

author.name

datePublished

hasPart.cssSelector

hasPart.isAccessibleForFree

headline

image

isAccessibleForFree

itemListElement[].name

speakable.cssSelector

url

Recommended properties (stack union)

dateModified

description

hasPart.url

itemListElement[].item

mainEntityOfPage

publisher.name

speakable.xpath

Combined JSON-LD

Paste as a single script tag. Keep product details, offer data, shipping/returns, and FAQ answers in sync with the page.

Validate

[
  {
    "@context": "https://schema.org",
    "@type": "NewsArticle",
    "@id": "https://www.example.com/news/ai-adoption-report#article",
    "headline": "AI Adoption Report 2026: Enterprises Accelerate Deployment",
    "description": "Key findings from the 2026 enterprise AI adoption survey across 1,200 organizations.",
    "datePublished": "2026-02-10T13:00:00Z",
    "dateModified": "2026-02-11T09:00:00Z",
    "url": "https://www.example.com/news/ai-adoption-report",
    "mainEntityOfPage": "https://www.example.com/news/ai-adoption-report",
    "image": [
      "https://www.example.com/images/ai-report-hero.webp"
    ],
    "author": {
      "@type": "Person",
      "name": "Casey Lin",
      "url": "https://www.example.com/authors/casey-lin"
    },
    "publisher": {
      "@type": "Organization",
      "name": "Example News",
      "url": "https://www.example.com",
      "logo": {
        "@type": "ImageObject",
        "url": "https://www.example.com/images/logo-120x60.png"
      }
    },
    "isAccessibleForFree": false,
    "hasPart": {
      "@type": "WebPageElement",
      "isAccessibleForFree": false,
      "cssSelector": ".paywall",
      "url": "https://www.example.com/news/ai-adoption-report/preview"
    },
    "speakable": {
      "@type": "SpeakableSpecification",
      "cssSelector": [
        "article h1",
        "article h2.lede"
      ]
    }
  },
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
      { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com" },
      { "@type": "ListItem", "position": 2, "name": "News", "item": "https://www.example.com/news" },
      { "@type": "ListItem", "position": 3, "name": "AI Adoption Report", "item": "https://www.example.com/news/ai-adoption-report" }
    ]
  }
]

Implementation steps

Start from your live product detail page content; ensure titles, prices, and availability match the page.
Embed one JSON-LD script in the head or just before the closing body tag using the combined example as a template.
Fill shipping details for each region you serve and keep them aligned with on-page shipping tables.
Attach your canonical MerchantReturnPolicy URL and keep the policy text in sync with Merchant Center.
Add 3–6 FAQs that address purchase blockers (shipping, returns, compatibility) and keep answers consistent with visible content.
Validate in the Rich Results Test and revalidate after price/availability/policy changes.

Common errors and fixes

Missing currency or availability: ensure `offers.priceCurrency` and `offers.availability` use ISO currency codes and schema URLs.
ShippingDetails missing destination or transit time: include `shippingDestination.addressCountry` and `deliveryTime.transitTime` with units.
MerchantReturnPolicy not linked: reference it from the Offer via `hasMerchantReturnPolicy` and provide a stable policy URL.
FAQ answers don't match the page: keep FAQ content identical to visible answers to avoid review or manual actions.

FAQs

Do I need both speakable and paywall markup?

If you support voice surfaces and a paywall, yes—speakable clarifies which content is eligible for voice, and paywall markup clarifies access.

Should I use Article or NewsArticle?

Use NewsArticle for news/publisher content that meets freshness and E-E-A-T expectations; otherwise use Article.

SwiftSchema

Intuitive Schema Generation at Your Fingertips