Cookies & analytics

    We use cookies for analytics and to serve ads. Accept to enable Google Analytics and AdSense. You can decline to stay opt-out.

    SwiftSchema Logo

    SwiftSchema

    Intuitive Schema Generation at Your Fingertips

    AboutLearnContact
      Stack

      Site Search Stack

      Internal search results pages with WebSite search action, SearchResultsPage, FAQs, and breadcrumb context.

      Open generatorValidate in Rich Results Test

      When to use this stack

      • Internal search results pages that need structured context
      • Sites wanting clear site search eligibility and navigation
      • Pages where FAQs clarify how search works or what’s indexed

      What's included

      Required properties (stack union)

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

      itemListElement[].name
      mainEntity[].@type=Question
      mainEntity[].acceptedAnswer.text
      name
      potentialAction.query-input
      potentialAction.target
      url

      Recommended properties (stack union)

      description
      itemListElement[].item
      mainEntity[].acceptedAnswer.text
      mainEntity[].author.name
      mainEntity[].name

      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": "WebSite",
    "@id": "https://www.example.com/#website",
    "name": "Example Site",
    "url": "https://www.example.com",
    "potentialAction": {
      "@type": "SearchAction",
      "target": "https://www.example.com/search?q={search_term_string}",
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "@type": "SearchResultsPage",
    "@id": "https://www.example.com/search?q=wireless+headphones#page",
    "name": "Search results for wireless headphones",
    "url": "https://www.example.com/search?q=wireless+headphones",
    "description": "Results for wireless headphones across products and guides."
  },
  {
    "@context": "https://schema.org",
    "@type": "FAQPage",
    "mainEntity": [
      { "@type": "Question", "name": "What does site search include?", "acceptedAnswer": { "@type": "Answer", "text": "Products, guides, and FAQs are indexed. Archived pages are excluded." } },
      { "@type": "Question", "name": "How do I filter results?", "acceptedAnswer": { "@type": "Answer", "text": "Use filters on the left to narrow by category and price." } }
    ]
  },
  {
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "itemListElement": [
      { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com" },
      { "@type": "ListItem", "position": 2, "name": "Search", "item": "https://www.example.com/search" }
    ]
  }
]

      Implementation steps

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

      Common errors and fixes

      FAQs

      Can I use this on faceted search pages?

      Yes. Ensure the JSON-LD matches the visible search page and query.

      Do I need WebPage?

      SearchResultsPage is a WebPage subtype, so no separate WebPage object is necessary.

      References