XooCode(){

MovieSeries

MovieSeries is a CreativeWorkSeries subtype for a film franchise: a trilogy, a multi-film series, a shared-universe franchise. It adds 5 direct properties: actor, director, musicBy, productionCompany, trailer.

Individual films in the series are Movie entries linked via hasPart. Use position on each Movie to encode chronological release order.

Full example of schema.org/MovieSeries json-ld markup

The markup is verified as valid with Rich Results Test from Google.

Highlight legend:Required by GoogleRecommendedOptional
schema.org/MovieSeries
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "MovieSeries",
  "name": "Datasets",
  "description": "Three-film trilogy about a rogue statistician who discovers a dataset that can predict the end of the world.",
  "startDate": "2023-10-20",
  "endDate": "2026-10-23",
  "director": { "@type": "Person", "name": "Jane Xoo" },
  "musicBy": { "@type": "Person", "name": "Marcus Okwuosa" },
  "productionCompany": { "@type": "Organization", "name": "Xoo Code Studios" },
  "actor": { "@type": "Person", "name": "Nora Lindgren" },
  "hasPart": [
    { "@type": "Movie", "name": "Datasets", "datePublished": "2023-10-20", "position": 1 },
    { "@type": "Movie", "name": "Datasets: Outliers", "datePublished": "2025-03-07", "position": 2 },
    { "@type": "Movie", "name": "Datasets: Final Regression", "datePublished": "2026-10-23", "position": 3 }
  ]
}
</script>

Minimal valid version

The smallest markup that still produces a valid MovieSeries entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.

schema.org/MovieSeries (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "MovieSeries",
  "name": "Datasets",
  "productionCompany": { "@type": "Organization", "name": "Xoo Code Studios" }
}
</script>

Google rich results this unlocks

Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.

  • Movie rich result (via member Movie entries)primary
    Google docs

Common MovieSeries mistakes

Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.

  1. 01

    Using MovieSeries for a single film

    Wrong
    MovieSeries for a standalone movie
    Right
    Movie for a single film; MovieSeries only for franchises with 2+ films

    MovieSeries implies a multi-film franchise. A standalone movie should be Movie directly.

Schema properties in this example

MovieSeriesCreativeWorkSeriesnamedescriptionstartDateendDatedirectorPersonmusicByproductionCompanyOrganizationactorhasPartMoviedatePublishedpositiontrailer

About the example data

The fictional three-film "Datasets" trilogy by Xoo Code Studios, released 2023-2026.

Comments

Loading comments...

Leave a comment