Schema: contentUrl

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.

ImageObject JSON-LD example with content URL, dimensions, caption, creator, copyright holder, license, and acquisition source. The image metadata structure used inside Article, Product, Person, and any type with an image property.

Dataset JSON-LD example for Jane Xoo's 1945-1955 pediatric outcome data. Covers distribution with DataDownload for file formats, temporalCoverage and spatialCoverage, variableMeasured, license, measurementTechnique, and how Dataset markup feeds Google Dataset Search.

Photograph JSON-LD example for a portrait of Jane Xoo from 1945. Covers contentUrl, thumbnail, exifData with PropertyValue pairs, copyrightHolder, acquireLicensePage for licensing, locationCreated with Place, and how Photograph differs from ImageObject for standalone photo pages.

DigitalDocument JSON-LD example for a downloadable PDF whitepaper on structured data ROI. Covers hasDigitalDocumentPermission for access control, encoding with MediaObject for file metadata, pagination, and how DigitalDocument differs from Article for non-HTML published content.

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.

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.

MediaObject JSON-LD example for a downloadable PDF report. MediaObject is the parent of VideoObject, AudioObject, and ImageObject. Covers the most important of its 20 direct properties: contentUrl, encodingFormat, contentSize, duration, uploadDate, and requiresSubscription.

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.

Map JSON-LD example for a museum venue map. Covers the mapType property with the full MapCategoryType enumeration (ParkingMap, SeatingMap, TransitMap, VenueMap) and how Map relates to downloadable site plans, seating charts, and transit diagrams.

Barcode JSON-LD example for a ticket barcode. Barcode is an ImageObject subtype with no properties of its own; it inherits the full ImageObject vocabulary (contentUrl, encodingFormat, caption, embeddedTextCaption, width, height).

SocialMediaPosting JSON-LD example for a microblog post with a shared image. SocialMediaPosting is an Article subtype that adds one property, sharedContent, for the embedded asset being shared or quoted. It is the parent of BlogPosting and DiscussionForumPosting.

3DModel JSON-LD example for a 3D asset (GLB, GLTF, USDZ) used in AR, VR, gaming, or product viewers. MediaObject subtype adding the isResizable property.

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.

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.

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.

HyperTocEntry JSON-LD example for a single entry in a HyperToc. Pending CreativeWork subtype adding associatedMedia, tocContinuation, and utterances. Time range via inherited startOffset/endOffset.

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.

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.

HowToDirection JSON-LD example for a single action within a HowTo. Dual-inherits ListItem + CreativeWork. Adds afterMedia / beforeMedia / duringMedia, performTime, supply, tool.

ImageGallery JSON-LD example for a photo-gallery page. Direct CollectionPage subtype. Use ItemList + ImageObject for the gallery contents.

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

DataDownload JSON-LD example for a downloadable distribution of a Dataset (CSV, JSON, Parquet). MediaObject subtype. Attach via Dataset.distribution.

LegislationObject JSON-LD example for the published file of a piece of Legislation (PDF / HTML / XML). Dual-inherits Legislation + MediaObject with legislationLegalValue.

PresentationDigitalDocument JSON-LD example for a slide deck (Keynote, PowerPoint, Google Slides). Direct DigitalDocument subtype with no unique properties.

SpreadsheetDigitalDocument JSON-LD example for a spreadsheet (Excel, Google Sheets, Numbers). Direct DigitalDocument subtype with no unique properties.

TextDigitalDocument JSON-LD example for a long-form text document (Word, Pages, Google Docs). Direct DigitalDocument subtype with no unique properties.

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.