XooCode(){

VideoGameSeries

VideoGameSeries is the container for a game franchise (a multi-title series like "The Legend of Zelda") or an ongoing live-service title broken into seasons. It sits under CreativeWorkSeries and loads up the fullest property set in the whole series tree — 22 direct properties — because a game series has to describe gameplay, platforms, creative credits, and serial structure at once.

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

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

Highlight legend:Required by GoogleRecommendedOptional
schema.org/VideoGameSeries
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoGameSeries",
  "name": "XooQuest",
  "alternateName": "The XooQuest Saga",
  "url": "https://xooquest.example",
  "image": "https://xooquest.example/key-art.png",
  "description": "An action-RPG franchise set in the shattered kingdom of Dunmore.",
  "startDate": "2022-03-15",
  "productionCompany": {
    "@type": "Organization",
    "name": "Dunmore Interactive"
  },
  "director": {
    "@type": "Person",
    "name": "Sean Dunmore"
  },
  "musicBy": {
    "@type": "MusicGroup",
    "name": "Dunmore Symphony"
  },
  "actor": [
    { "@type": "Person", "name": "Adelaide Voss" },
    { "@type": "Person", "name": "Roman Halliwell" }
  ],
  "gamePlatform": ["PlayStation 5", "Xbox Series X", "Nintendo Switch", "Windows"],
  "playMode": "SinglePlayer",
  "numberOfPlayers": {
    "@type": "QuantitativeValue",
    "minValue": 1,
    "maxValue": 1
  },
  "gameLocation": "The Kingdom of Dunmore (fictional)",
  "numberOfSeasons": 4,
  "numberOfEpisodes": 48,
  "containsSeason": [
    { "@type": "CreativeWorkSeason", "name": "Season 1: The Shattering", "seasonNumber": 1, "startDate": "2022-03-15" },
    { "@type": "CreativeWorkSeason", "name": "Season 2: Iron and Rust", "seasonNumber": 2, "startDate": "2022-09-01" },
    { "@type": "CreativeWorkSeason", "name": "Season 3: The Long Night", "seasonNumber": 3, "startDate": "2023-04-12" },
    { "@type": "CreativeWorkSeason", "name": "Season 4: Dawn of Xoo", "seasonNumber": 4, "startDate": "2024-01-18" }
  ],
  "trailer": {
    "@type": "VideoObject",
    "name": "XooQuest — Launch Trailer",
    "thumbnailUrl": "https://xooquest.example/trailer-thumb.jpg",
    "contentUrl": "https://xooquest.example/trailer.mp4",
    "uploadDate": "2022-02-01",
    "duration": "PT2M14S"
  }
}
</script>

Direct properties (22)

Serial structure: numberOfSeasons, numberOfEpisodes, season / seasons / containsSeason, episode / episodes. A game series that runs as seasons (Fortnite, Destiny) populates these; a franchise of standalone titles leaves them empty and uses hasPart to link the individual VideoGame nodes instead.

Gameplay: numberOfPlayers (QuantitativeValue with minValue/maxValue for co-op/multiplayer ranges), playMode (SinglePlayer, MultiPlayer, CoOp), gamePlatform (PlayStation, Xbox, Switch, PC; Text or Thing), gameLocation (real or fictional setting), cheatCode, quest, gameItem, characterAttribute.

Creative credits: actor / actors, director / directors, musicBy, productionCompany, trailer (VideoObject).

Series or single game?

VideoGameSeries is for the franchise. Individual titles are VideoGame nodes linked via hasPart. For a single game with campaigns or chapters that map to "seasons", the season pattern fits — populate containsSeason with CreativeWorkSeason entries.

Minimal valid version

The smallest markup that still produces a valid VideoGameSeries 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/VideoGameSeries (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoGameSeries",
  "name": "XooQuest",
  "gamePlatform": ["PlayStation 5", "Windows"],
  "playMode": "SinglePlayer",
  "numberOfSeasons": 4
}
</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.

  • No dedicated rich result (feeds game knowledge panels + AI search)
    Google docs

Common VideoGameSeries 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

    Single game published as VideoGameSeries

    Wrong
    VideoGameSeries for a one-off title
    Right
    VideoGame for standalone games; VideoGameSeries only for franchises or season-based titles

    Consumers interpret VideoGameSeries as a multi-title container. Using it for a single game breaks knowledge-graph linking.

  2. 02

    Platforms as one comma-joined string

    Wrong
    "gamePlatform": "PS5, Xbox, Switch"
    Right
    Array of strings or Thing nodes

    A joined string is one platform called "PS5, Xbox, Switch" — none of which match any known platform.

  3. 03

    playMode as free text

    Wrong
    "playMode": "single player"
    Right
    "playMode": "SinglePlayer"

    GamePlayMode is a closed enum: SinglePlayer / MultiPlayer / CoOp. Free text is dropped.

Schema properties in this example

VideoGameSeriesCreativeWorkSeriesCreativeWorknamealternateNameurlimagedescriptionstartDateproductionCompanyOrganizationdirectorPersonmusicByMusicGroupactorgamePlatformplayModenumberOfPlayersQuantitativeValueminValuemaxValuegameLocationnumberOfSeasonsnumberOfEpisodescontainsSeasonCreativeWorkSeasonseasonNumbertrailerVideoObjectthumbnailUrlcontentUrluploadDatedurationcheatCodequestgameItemcharacterAttributeactorsdirectorsepisodeepisodesseasonseasons

Also mentioned in 1 other example

VideoGameSeries also appears in CreativeWorkSeries. See the full VideoGameSeries schema page for every reference.

About the example data

"XooQuest" — the Dunmore Interactive flagship RPG franchise. Three mainline games across PlayStation / Xbox / PC, score by the Dunmore Symphony, directed by Sean Dunmore, live-service content split into four seasons.

Comments

Loading comments...

Leave a comment