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

      Promo / Coupon Stack

      Promo/coupon landing pages with offers, returns/terms, FAQs, and breadcrumb context.

      Open generatorValidate in Rich Results Test

      When to use this stack

      • Coupon or promo landing pages for products or categories
      • Sale pages needing structured offer terms and return/shipping clarity
      • Pages where FAQs explain eligibility, exclusions, and duration

      What's included

      • Collection Page
        Open generator

        Declares the page as a promo or coupon hub.

      • Defines the promo offer with price/discount context and validity.

      • Merchant Return Policy
        Open generator

        Clarifies return policy terms that apply to promo items.

      • Frequently Asked Questions
        Open generator

        Answers promo eligibility, stacking, exclusions, and timing questions.

      • Breadcrumb
        Open generator

        Provides navigation context for the promo page.

      Required properties (stack union)

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

      availability
      description
      itemListElement[].name
      mainEntity[].@type=Question
      mainEntity[].acceptedAnswer.text
      name
      price
      priceCurrency
      returnFees
      returnMethod
      returnPolicyCategory
      url

      Recommended properties (stack union)

      applicableCountry
      category
      inStoreReturnsOffered
      itemListElement[].item
      mainEntity.@id
      mainEntity[].acceptedAnswer.text
      mainEntity[].author.name
      mainEntity[].name
      merchantReturnDays
      name
      priceValidUntil
      restockingFee
      url

      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": "CollectionPage",
          "@id": "https://www.example.com/promos/winter-sale#page",
          "name": "Winter Sale — Up to 40% Off",
          "description": "Winter sale on outerwear with up to 40% off select styles.",
          "url": "https://www.example.com/promos/winter-sale",
          "mainEntity": {
            "@type": "Offer",
            "@id": "https://www.example.com/promos/winter-sale#offer"
          }
        },
        {
          "@context": "https://schema.org",
          "@type": "Offer",
          "@id": "https://www.example.com/promos/winter-sale#offer",
          "name": "40% off winter outerwear",
          "category": "SeasonalSale",
          "price": "0.00",
          "priceCurrency": "USD",
          "availability": "https://schema.org/InStock",
          "url": "https://www.example.com/promos/winter-sale#shop",
          "priceValidUntil": "2026-12-31"
        },
        {
          "@context": "https://schema.org",
          "@type": "MerchantReturnPolicy",
          "@id": "https://www.example.com/policies/returns#winter-sale",
          "name": "Winter sale returns",
          "url": "https://www.example.com/policies/returns",
          "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
          "merchantReturnDays": 30,
          "returnMethod": "https://schema.org/ReturnByMail",
          "returnFees": "https://schema.org/FreeReturn",
          "applicableCountry": "US"
        },
        {
          "@context": "https://schema.org",
          "@type": "FAQPage",
          "mainEntity": [
            {
              "@type": "Question",
              "name": "Can I stack this with other discounts?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "No. This promo cannot be combined with other codes or sitewide promotions."
              }
            },
            {
              "@type": "Question",
              "name": "Are sale items returnable?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Yes. Winter sale items follow our standard 30-day return policy. Final sale items are labeled on the product page."
              }
            },
            {
              "@type": "Question",
              "name": "When does the offer expire?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "The Winter Sale ends December 31, 2026 at 11:59pm PT or while supplies last."
              }
            }
          ]
        },
        {
          "@context": "https://schema.org",
          "@type": "BreadcrumbList",
          "itemListElement": [
            { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com" },
            { "@type": "ListItem", "position": 2, "name": "Promos", "item": "https://www.example.com/promos" },
            { "@type": "ListItem", "position": 3, "name": "Winter Sale", "item": "https://www.example.com/promos/winter-sale" }
          ]
        }
      ]

      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

      How do I show multiple promo codes?

      Include one Offer per active promo on the page. Keep each code’s validity and URL aligned to the visible content.

      Do I need returns for every promo?

      Use a MerchantReturnPolicy that matches the terms shown on the page. For final sale, set returnPolicyCategory accordingly.

      References