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

      Subscription Box Stack

      Subscription box pages with Product, OfferShippingDetails, MerchantReturnPolicy, FAQs, and breadcrumb navigation.

      Open generatorValidate in Rich Results Test

      When to use this stack

      • Subscription box product pages (meal kits, lifestyle boxes, curated goods)
      • Pages that need clear shipping cadence, delivery regions, and return policies
      • Pages where FAQs clarify billing cycles, skipping, and cancellations

      What's included

      • Identifies the subscription box product with offer details.

      • Offer Shipping Details
        Open generator

        Defines delivery regions and cadence for the subscription shipping.

      • Merchant Return Policy
        Open generator

        Clarifies return/cancellation policy for the subscription box.

      • Frequently Asked Questions
        Open generator

        Answers billing, skipping, and cancellation questions.

      • Breadcrumb
        Open generator

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

      description
      image
      itemListElement[].name
      mainEntity[].@type=Question
      mainEntity[].acceptedAnswer.text
      name
      offers.availability
      offers.price
      offers.priceCurrency
      offers.shippingDetails[].deliveryTime.transitTime
      offers.shippingDetails[].shippingDestination.addressCountry
      offers.shippingDetails[].shippingRate.currency
      offers.url
      returnFees
      returnMethod
      returnPolicyCategory

      Recommended properties (stack union)

      applicableCountry
      brand.name
      category
      inStoreReturnsOffered
      itemListElement[].item
      mainEntity[].acceptedAnswer.text
      mainEntity[].author.name
      mainEntity[].name
      merchantReturnDays
      offers.shippingDetails[].deliveryTime.handlingTime
      offers.shippingDetails[].shippingDestination.addressRegion
      offers.shippingDetails[].shippingRate.value
      restockingFee
      sku
      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": "Product",
          "@id": "https://www.example.com/subscriptions/snack-box#product",
          "name": "Global Snack Box — Monthly Subscription",
          "description": "A curated box of 12 international snacks delivered monthly.",
          "image": [
            "https://www.example.com/images/snack-box-front.webp",
            "https://www.example.com/images/snack-box-contents.webp"
          ],
          "sku": "SNACK-BOX-MO",
          "brand": { "@type": "Brand", "name": "Example Snacks" },
          "category": "FoodSubscription",
          "offers": {
            "@type": "Offer",
            "@id": "https://www.example.com/subscriptions/snack-box#offer",
            "price": "29.00",
            "priceCurrency": "USD",
            "availability": "https://schema.org/InStock",
            "url": "https://www.example.com/subscriptions/snack-box/checkout",
            "shippingDetails": [
              {
                "@type": "OfferShippingDetails",
                "shippingDestination": {
                  "@type": "DefinedRegion",
                  "addressCountry": "US"
                },
                "deliveryTime": {
                  "@type": "ShippingDeliveryTime",
                  "transitTime": {
                    "@type": "QuantitativeValue",
                    "minValue": 3,
                    "maxValue": 7,
                    "unitCode": "d"
                  }
                },
                "shippingRate": {
                  "@type": "MonetaryAmount",
                  "currency": "USD",
                  "value": "5.00"
                }
              }
            ],
            "hasMerchantReturnPolicy": "https://www.example.com/policies/subscriptions#returns"
          }
        },
        {
          "@context": "https://schema.org",
          "@type": "MerchantReturnPolicy",
          "@id": "https://www.example.com/policies/subscriptions#returns",
          "name": "Subscription box returns",
          "url": "https://www.example.com/policies/subscriptions",
          "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
          "merchantReturnDays": 14,
          "returnMethod": "https://schema.org/ReturnByMail",
          "returnFees": "https://schema.org/FreeReturn",
          "applicableCountry": "US"
        },
        {
          "@context": "https://schema.org",
          "@type": "FAQPage",
          "mainEntity": [
            {
              "@type": "Question",
              "name": "Can I skip a month?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Yes. Pause or skip any month before your billing date in your account."
              }
            },
            {
              "@type": "Question",
              "name": "When will I be billed?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Billing occurs on the 1st of each month for the upcoming shipment."
              }
            },
            {
              "@type": "Question",
              "name": "What if an item arrives damaged?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Contact support within 7 days for a replacement item or credit."
              }
            }
          ]
        },
        {
          "@context": "https://schema.org",
          "@type": "BreadcrumbList",
          "itemListElement": [
            { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com" },
            { "@type": "ListItem", "position": 2, "name": "Subscriptions", "item": "https://www.example.com/subscriptions" },
            { "@type": "ListItem", "position": 3, "name": "Snack Box", "item": "https://www.example.com/subscriptions/snack-box" }
          ]
        }
      ]

      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 MerchantReturnPolicy if boxes are final sale?

      Yes—set returnPolicyCategory to the correct type (e.g., NoReturn) and keep it aligned with on-page policy language.

      How do I show different regions?

      Add multiple OfferShippingDetails entries for each region shown on the page with accurate rates and transit times.

      References