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

      Playlist / Series Stack

      Playlist/series hubs with an ItemList of audio/video entries, FAQs, and breadcrumb navigation.

      Open generatorValidate in Rich Results Test

      When to use this stack

      • Video or podcast series hubs listing multiple episodes
      • Playlists for tutorials, webinars, or music releases
      • Pages where FAQs clarify schedule, availability, and formats

      What's included

      • Represents the playlist/series list on the page.

      • Video Object
        Open generator

        Defines each video entry with source URL, duration, and dates.

      • Audio Object
        Open generator

        Optional audio entries if the playlist includes podcast/audio episodes.

      • Frequently Asked Questions
        Open generator

        Answers cadence, access, and format questions.

      • Breadcrumb
        Open generator

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

      contentUrl
      description
      duration
      itemListElement[].@type=ListItem
      itemListElement[].item.@id
      itemListElement[].name
      mainEntity[].@type=Question
      mainEntity[].acceptedAnswer.text
      name
      uploadDate

      Recommended properties (stack union)

      encodingFormat
      inLanguage
      itemListElement[].item
      itemListElement[].item.@type=VideoObject
      itemListElement[].item.description
      itemListElement[].item.name
      itemListElement[].position
      mainEntity[].acceptedAnswer.text
      mainEntity[].author.name
      mainEntity[].name
      thumbnailUrl
      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": "ItemList",
          "@id": "https://www.example.com/series/platform-updates#list",
          "name": "Platform Updates Series",
          "itemListElement": [
            {
              "@type": "ListItem",
              "position": 1,
              "item": { "@id": "https://www.example.com/series/platform-updates/episode-5#video" }
            },
            {
              "@type": "ListItem",
              "position": 2,
              "item": { "@id": "https://www.example.com/series/platform-updates/episode-4#audio" }
            }
          ]
        },
        {
          "@context": "https://schema.org",
          "@type": "VideoObject",
          "@id": "https://www.example.com/series/platform-updates/episode-5#video",
          "name": "Episode 5 — New Dashboard",
          "description": "Walkthrough of the new analytics dashboard and alerting.",
          "uploadDate": "2025-02-20",
          "duration": "PT18M30S",
          "contentUrl": "https://cdn.example.com/video/episode-5.mp4",
          "thumbnailUrl": "https://www.example.com/images/episode-5-thumb.webp",
          "inLanguage": "en",
          "url": "https://www.example.com/series/platform-updates/episode-5"
        },
        {
          "@context": "https://schema.org",
          "@type": "AudioObject",
          "@id": "https://www.example.com/series/platform-updates/episode-4#audio",
          "name": "Episode 4 — Scaling Search",
          "description": "Podcast episode on scaling search infrastructure.",
          "uploadDate": "2025-02-13",
          "duration": "PT27M15S",
          "contentUrl": "https://cdn.example.com/audio/episode-4.mp3",
          "encodingFormat": "audio/mpeg",
          "inLanguage": "en",
          "url": "https://www.example.com/series/platform-updates/episode-4"
        },
        {
          "@context": "https://schema.org",
          "@type": "FAQPage",
          "mainEntity": [
            {
              "@type": "Question",
              "name": "How often do new episodes ship?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "We publish weekly on Thursdays. Episodes are added here as soon as they go live."
              }
            },
            {
              "@type": "Question",
              "name": "Can I download episodes?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Yes. Use the download links on each episode page for video MP4 or audio MP3."
              }
            },
            {
              "@type": "Question",
              "name": "Are transcripts available?",
              "acceptedAnswer": {
                "@type": "Answer",
                "text": "Yes. Each episode page links to a transcript once it’s published."
              }
            }
          ]
        },
        {
          "@context": "https://schema.org",
          "@type": "BreadcrumbList",
          "itemListElement": [
            { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://www.example.com" },
            { "@type": "ListItem", "position": 2, "name": "Series", "item": "https://www.example.com/series" },
            { "@type": "ListItem", "position": 3, "name": "Platform Updates", "item": "https://www.example.com/series/platform-updates" }
          ]
        }
      ]

      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 both VideoObject and AudioObject?

      Include the media types you actually show. If the playlist is video-only, you can omit AudioObject and adjust ItemList items accordingly.

      Should I include transcripts?

      Link transcripts from each episode page and align associatedMedia/transcript there; keep this page focused on the playlist.

      References