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

      Category / Sale Stack

      Sale or promo collection pages with ItemList, delivery/returns policies, FAQs, and breadcrumb context.

      Open generatorValidate in Rich Results Test

      When to use this stack

      • Sale or promo landing pages listing discounted products
      • Category pages that need explicit delivery/returns signals for Merchant Center alignment
      • Pages where FAQs reduce friction around sale terms and shipping

      What's included

      • Collection Page
        Open generator

        Declares the page as a sale or category landing.

      • Structures the sale items list with order and IDs.

      • Offer Shipping Details
        Open generator

        Clarifies delivery regions, handling/transit times, and shipping rates to reduce warnings.

      • Merchant Return Policy
        Open generator

        Defines returns window, method, and fees for sale items.

      • Frequently Asked Questions
        Open generator

        Addresses sale terms, shipping, returns, and exclusions.

      • Breadcrumb
        Open generator

        Provides navigation context for the sale 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`).

      deliveryTime.transitTime
      description
      itemListElement[].item.@id
      itemListElement[].name
      itemListElement[].position
      mainEntity[].@type=Question
      mainEntity[].acceptedAnswer.text
      name
      returnFees
      returnMethod
      returnPolicyCategory
      shippingDestination.addressCountry
      shippingRate.currency
      url

      Recommended properties (stack union)

      applicableCountry
      deliveryTime.businessDays
      deliveryTime.handlingTime
      inStoreReturnsOffered
      itemListElement[].item
      itemListElement[].name
      itemListOrder
      mainEntity.@id
      mainEntity[].acceptedAnswer.text
      mainEntity[].author.name
      mainEntity[].name
      merchantReturnDays
      numberOfItems
      restockingFee
      shippingDestination.addressRegion
      shippingRate.value
      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/sale/winter-gear#collection",
          "name": "Winter Gear Sale",
          "description": "Up to 40% off winter jackets, base layers, and boots.",
          "url": "https://www.example.com/sale/winter-gear",
          "mainEntity": {
            "@type": "ItemList",
            "@id": "https://www.example.com/sale/winter-gear#list"
          }
        },
        {
          "@context": "https://schema.org",
          "@type": "ItemList",
          "@id": "https://www.example.com/sale/winter-gear#list",
          "itemListOrder": "https://schema.org/ItemListOrderDescending",
          "numberOfItems": 2,
          "itemListElement": [
            {
              "@type": "ListItem",
              "position": 1,
              "name": "Alpine Down Parka",
              "item": { "@id": "https://www.example.com/products/alpine-parka#product" },
              "url": "https://www.example.com/products/alpine-parka"
            },
            {
              "@type": "ListItem",
              "position": 2,
              "name": "Summit Hybrid Jacket",
              "item": { "@id": "https://www.example.com/products/summit-hybrid#product" },
              "url": "https://www.example.com/products/summit-hybrid"
            }
          ]
        },
        {
          "@context": "https://schema.org",
          "@type": "OfferShippingDetails",
          "shippingDestination": {
            "@type": "DefinedRegion",
            "addressCountry": "US"
          },
          "deliveryTime": {
            "@type": "ShippingDeliveryTime",
            "handlingTime": {
              "@type": "QuantitativeValue",
              "minValue": 0,
              "maxValue": 1,
              "unitCode": "d"
            },
            "transitTime": {
              "@type": "QuantitativeValue",
              "minValue": 2,
              "maxValue": 5,
              "unitCode": "d"
            }
          },
          "shippingRate": {
            "@type": "MonetaryAmount",
            "value": "0.00",
            "currency": "USD"
          }
        },
        {
          "@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": "Are sale items eligible for free shipping?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Yes. Ground shipping is free in the US on sale items. Expedited options are available at checkout."
              }
            },
            {
              "@type": "Question",
              "name": "Do sale items follow the same return policy?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Yes. You have 30 days from delivery to return sale items in new condition."
              }
            },
            {
              "@type": "Question",
              "name": "Are there exclusions?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Final sale items will be labeled on the product page. Most other items are eligible for returns."
              }
            }
          ]
        },
        {
          "@context": "https://schema.org",
          "@type": "BreadcrumbList",
          "itemListElement": [
            { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com" },
            { "@type": "ListItem", "position": 2, "name": "Sale", "item": "https://www.example.com/sale" },
            { "@type": "ListItem", "position": 3, "name": "Winter Gear", "item": "https://www.example.com/sale/winter-gear" }
          ]
        }
      ]

      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

      Do I need Product markup here?

      Optional. Include Product objects for featured items if present on the page. Keep IDs and prices in sync with the visible listings.

      How should I localize shipping/returns?

      Add multiple OfferShippingDetails entries per region and set MerchantReturnPolicy applicableCountry accordingly. Align with what’s shown on the page.

      References