XooCode(){

Clip

Clip is a CreativeWork subtype for a segment of audio or video — the "key moment" markers inside a longer VideoObject. It adds 9 direct properties:

  • startOffset, endOffset (Number, seconds from start): the time range of the clip within the parent media.
  • clipNumber (Integer or Text): sequence number inside an episode.
  • partOfEpisode / partOfSeason / partOfSeries: linking into the TV or podcast graph.
  • actor, director, musicBy: people credited within the clip.

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

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

Highlight legend:Required by GoogleRecommendedOptional
schema.org/Clip
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "name": "Structured Data 101",
  "description": "An introduction to schema.org structured data, focused on recipes, products, and articles.",
  "contentUrl": "https://xoocode.com/videos/structured-data-101.mp4",
  "uploadDate": "2026-03-01",
  "duration": "PT12M40S",
  "hasPart": [
    { "@type": "Clip", "name": "What is schema.org?", "startOffset": 0, "endOffset": 90, "url": "https://xoocode.com/videos/structured-data-101?t=0" },
    { "@type": "Clip", "name": "Product rich results demo", "startOffset": 180, "endOffset": 360, "url": "https://xoocode.com/videos/structured-data-101?t=180" },
    { "@type": "Clip", "name": "Common validator mistakes", "startOffset": 540, "endOffset": 720, "url": "https://xoocode.com/videos/structured-data-101?t=540" }
  ]
}
</script>

Google key-moments

Structured Clip entries power Google's video "key moments" feature: chapter-like bookmarks inside a YouTube or hosted video. Attach Clip entries via hasPart on the parent VideoObject.

Minimal valid version

The smallest markup that still produces a valid Clip 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/Clip (minimal)
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Clip",
  "name": "Product rich results demo",
  "startOffset": 180,
  "endOffset": 360
}
</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.

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

    Offsets as ISO 8601 durations

    Wrong
    "startOffset": "PT3M"
    Right
    "startOffset": 180 (seconds as Number)

    Clip offsets expect seconds as a Number, not ISO 8601.

  2. 02

    Missing hasPart linkage from the parent video

    Wrong
    Clips published standalone, not linked from a VideoObject
    Right
    VideoObject with hasPart array of Clip entries

    Google's key-moments feature reads clips from the parent video's hasPart; standalone clips are not discovered.

Schema properties in this example

ClipCreativeWorkVideoObjectnamedescriptioncontentUrluploadDatedurationhasPartstartOffsetendOffseturlclipNumberpartOfEpisodepartOfSeasonpartOfSeriesactordirectormusicBy

Also mentioned in 7 other examples

Clip also appears in HyperToc, MovieClip, RadioClip, SeekToAction, TVClip, VideoGameClip, and VideoObject. See the full Clip schema page for every reference.

About the example data

Three key-moment clips inside the Xoo Code "Structured Data 101" intro video.

Comments

Loading comments...

Leave a comment