Schema: Duration

VideoObject JSON-LD example for a product walkthrough video with five key-moment Clips, ISO 8601 duration, interactionStatistic view count, and publisher cross-referencing the Xoo Code Shop Dunmore LocalBusiness entity. Covers contentUrl vs embedUrl, the hasPart Clip pattern for key moments, and the duration format developers get wrong.

Movie JSON-LD example for a documentary about Jane Xoo's pediatric work. Covers director, actor, duration in ISO 8601, contentRating, releasedEvent for premiere details, aggregateRating, review with nested Rating, and the WatchAction pattern for streaming links that Google uses to build the movie knowledge panel.

MusicRecording JSON-LD example for a film score track from The Children's Doctor documentary. Covers byArtist, recordingOf with MusicComposition and ISWC code, ISRC code, inAlbum cross-reference, duration in ISO 8601, and ListenAction for streaming links.

MusicAlbum JSON-LD example for The Children's Doctor film score. Covers track listing with MusicRecording references, numTracks, albumProductionType and albumReleaseType enums, byArtist as a shared credit, and how MusicAlbum connects to MusicRecording via the track property.

PodcastEpisode JSON-LD example for the Xoo Code podcast discussing structured data with a guest. Covers partOfSeries with PodcastSeries, associatedMedia with AudioObject for the episode file, episodeNumber, seasonNumber, timeRequired, and how podcast markup feeds Google Podcasts and AI-powered podcast discovery.

MusicEvent JSON-LD example for a live concert by The Copenhagen Ensemble at The Thunderdome. Covers performer as MusicGroup, workPerformed for linking to compositions, doorTime vs startDate, ticket offers, and how MusicEvent differs from generic Event for concerts and live performances.

SportsEvent JSON-LD example for a Dunmore Dynamos basketball game. Covers homeTeam and awayTeam as SportsTeam references, the generic competitor property for individual sports, sport, and how SportsEvent connects to SportsTeam entities in the knowledge graph.

EducationEvent JSON-LD example for a hands-on schema markup workshop at the Xoo Code Shop. Covers teaches, assesses, and educationalLevel (the 3 properties unique to EducationEvent), plus how EducationEvent differs from Course and why the instructor goes in performer.

AudioObject JSON-LD example for the Xoo Code podcast episode audio file. Covers caption, transcript, and embeddedTextCaption (the 3 properties unique to AudioObject), plus contentUrl, encodingFormat, and duration.

Duration reference page. Duration is a schema.org DataType (not a Thing subtype). Values are ISO 8601 duration strings like PT1H30M. Used on Movie, Recipe, Course, Event, JobPosting, and many other types for any time span property.

SeekToAction JSON-LD example for jumping to key moments in a video. SeekToAction is used as potentialAction on VideoObject to tell Google where within the video to jump to for a named moment.

VideoGame JSON-LD example for an electronic game. Inherits from both Game and SoftwareApplication, adding 10 properties: actor, cheatCode, director, gameEdition, gamePlatform, gameServer, gameTip, musicBy, playMode, trailer. Covers GamePlayMode enum (CoOp, MultiPlayer, SinglePlayer).

CreativeWorkSeason JSON-LD example for a single season of a TV, podcast, or radio series. Adds actor, director, episode, seasonNumber, numberOfEpisodes, partOfSeries, productionCompany, trailer, startDate, endDate. Parent of TVSeason.

Episode JSON-LD example for the parent of PodcastEpisode, RadioEpisode, and TVEpisode. Adds episodeNumber, partOfSeason, partOfSeries, actor, director, musicBy, productionCompany, trailer, and duration.

TVSeries JSON-LD example for a television show. CreativeWorkSeries subtype adding actor, director, containsSeason, episode, numberOfEpisodes, numberOfSeasons, productionCompany, musicBy, countryOfOrigin, trailer, titleEIDR.

TVSeason JSON-LD example for a single season of a television show. CreativeWorkSeason subtype adding countryOfOrigin and titleEIDR. Covers seasonNumber, numberOfEpisodes, startDate/endDate, trailer, partOfSeries.

TVEpisode JSON-LD example for a single episode of a TV show. Episode subtype adding countryOfOrigin, titleEIDR, subtitleLanguage, and partOfSeason.

RadioEpisode JSON-LD stub for a single episode of a radio show. Direct Episode subtype with no unique properties.

HyperToc JSON-LD example for a hypertext table of contents attached to a video or audio work. Pending CreativeWork subtype adding tocEntry (HyperTocEntry) and associatedMedia.

AmpStory JSON-LD stub for an AMP Story (visual, full-screen, tap-through content format). Dual-inherits from CreativeWork and MediaObject. Note: Google has deprecated Web Stories / AMP Stories in Search as of 2024.

MusicRelease JSON-LD example for a specific release of an album or EP (a vinyl pressing, a digital release, a CD). MusicPlaylist subtype adding catalogNumber, creditedTo, duration, musicReleaseFormat (MusicReleaseFormatType enum), recordLabel, releaseOf.

Clip JSON-LD example for a segment of audio or video (TV clip, podcast highlight, YouTube key-moment). CreativeWork subtype with clipNumber, startOffset, endOffset, partOfEpisode/Season/Series.

VideoGallery JSON-LD example for a video-collection page. Direct CollectionPage subtype. Use ItemList + VideoObject for the collection contents.

QuantitativeValueDistribution JSON-LD example for statistical distributions (median + percentiles 10/25/75/90 over a duration). StructuredValue parent of MonetaryAmountDistribution.

MonetaryAmountDistribution JSON-LD example for a currency-denominated distribution (wage percentiles, price ranges). QuantitativeValueDistribution subtype adding currency.

MusicComposition JSON-LD example for a musical work (distinct from MusicRecording which is a specific recording). CreativeWork subtype with composer, lyricist, iswcCode, musicalKey, firstPerformance, recordedAs.

VideoGameSeries JSON-LD example for a franchise or multi-title game series. CreativeWorkSeries subtype with 22 direct properties covering seasons, episodes, characters, quests, gameplay, platforms, and production credits.

InteractionCounter JSON-LD example for the aggregate likes / shares / comments / views count that sits under interactionStatistic on CreativeWork and Organization. StructuredValue subtype binding an Action type to a count, service, and optional time window.

Audiobook JSON-LD example — AudioObject + Book dual-inheritance with readBy and duration. Google Podcasts / audiobook knowledge panel.

TVClip JSON-LD reference — Clip subtype with partOfTVSeries. Short excerpt from a TV series (promo, highlight, recap).