Note: you are viewing the development version of Schema.org. See How we work for more details.

duration

A Schema.org Property
The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format.
Values expected to be one of these types
Duration
Used on these types
Audiobook
Episode
Event
MediaObject
Movie
MusicRecording
MusicRelease
QuantitativeValueDistribution
Schedule

Sub-properties

Source

https://github.com/schemaorg/schemaorg/issues/1457

https://github.com/schemaorg/schemaorg/issues/1698


Examples

Example 1
Copied
Example notes or example HTML without markup.
<b>12oclock_girona.mp3</b>
Total Time: 0m:15s - Recorded on a terrace of Girona a sunday morning
composed by Roger

 <script type="text/javascript">
var fo = new FlashObject("http://google.com/flash/preview-player.swf", "flashPlayer_719", "358", "16", "6", "#FFFFFF");fo.addVariable("url", "http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3");fo.addVariable("autostart", "0");fo.write("flashcontent_719");
</script>
Example encoded as Microdata embedded in HTML.
<div itemscope itemtype="https://schema.org/AudioObject">
  <span itemprop="name"><b>12oclock_girona.mp3</b></span>

<script type="text/javascript">
  var fo = new FlashObject("http://google.com/flash/preview-player.swf",
  "flashPlayer_719", "358", "16", "6", "#FFFFFF");fo.addVariable("url","http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3");fo.addVariable("autostart", "0");fo.write("flashcontent_719");
</script>

<meta itemprop="encodingFormat" content="audio/mpeg" />
 <meta itemprop="contentUrl" content="http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3" />

<span class="description">
      <meta itemprop="duration" content="T0M15S" />
      <span itemprop="description">Recorded on a terrace of Girona a sunday morning</span>
</span>
</div>
Example encoded as RDFa embedded in HTML.
<div vocab="https://schema.org/" typeof="AudioObject">
  <span property="name"><b>12oclock_girona.mp3</b></span>

<script type="text/javascript">
  var fo = new FlashObject("http://google.com/flash/preview-player.swf",
  "flashPlayer_719", "358", "16", "6", "#FFFFFF");fo.addVariable("url","http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3");fo.addVariable("autostart", "0");fo.write("flashcontent_719");
</script>

<meta property="encodingFormat" content="audio/mpeg" />
 <meta property="contentUrl" content="http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3" />

<span class="description">
      <meta property="duration" content="T0M15S" />
      <span property="description">Recorded on a terrace of Girona a sunday morning</span>
</span>
</div>
Example encoded as JSON-LD in a HTML script tag.
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "AudioObject",
  "contentUrl": "http://media.freesound.org/data/0/previews/719__elmomo__12oclock_girona_preview.mp3",
  "description": "Recorded on a terrace of Girona a sunday morning",
  "duration": "T0M15S",
  "encodingFormat": "audio/mpeg",
  "name": "12oclock_girona.mp3"
}
</script>
Structured representation of the JSON-LD example.
Example 2
Copied
Example notes or example HTML without markup.
<h1>Foo Fighters</h1>

<h2>Video: Interview with the Foo Fighters</h2>
<object ...>
  <param ...>
  <embed type="application/x-shockwave-flash" ...>
</object>
Catch this exclusive interview with Dave Grohl and the Foo Fighters
 about their new album, Rope.

<h2>Songs</h2>

Rope
 Length: 4:05 - 14300 plays
<a href="foo-fighters-rope-play.html">Play</a>
<a href="foo-fighters-rope-buy.html">Buy</a>
From album: <a href="foo-fighters-wasting-light.html">Wasting Light</a>

Everlong
 Length: 6:33 - 11700 plays
<a href="foo-fighters-everlong-play.html">Play</a>
<a href="foo-fighters-everlong-buy.html">Buy</a>
From album: <a href="foo-fighters-color-and-shape.html">The Color And The Shape</a>

<h2>Upcoming shows</h2>

<a href="foo-fighters-may20-fedexforum">FedExForum</a>
Memphis, TN, US
May 20
<a href="ticketworlds.com/foofighters/may20-2011">Buy tickets</a>

<a href="foo-fighters-may23-midamericacenter">Mid America Center</a>
Council Bluffs, IA, US
May 23
<a href="ticketworlds.com/foofighters/may23-2011">Buy tickets</a>

<h2><a href="foo-fighters-photos">28 Photos</a></h2>
<a href="foofighters-1.jpg"><img
alt="Thumbnail and linked photo of Foo Fighters band"
src="foofighters-thumb1.jpg" /></a>
<a href="foofighters-2.jpg"><img
alt="Thumbnail and linked photo of Foo Fighters band"
src="foofighters-thumb2.jpg" /></a>
<a href="foofighters-3.jpg"><img
alt="Thumbnail and linked photo of Foo Fighters band"
src="foofighters-thumb3.jpg" /></a>

<h2>Comments:</h2>
Excited about seeing them in concert next week. -Lawrence , Jan 23
I dig their latest single. -Mary, Jan 19
Showing 1-2 of 18 comments. <a href="foofighters-comments">More</a>
Example encoded as Microdata embedded in HTML.
<div itemscope itemtype="https://schema.org/MusicGroup">
    <h1 itemprop="name">
        Foo Fighters
    </h1>
    <div itemprop="subjectOf" itemscope itemtype="https://schema.org/VideoObject">
        <h2>
            Video: <span itemprop="name">Interview with the Foo Fighters</span>
        </h2>
        <meta itemprop="duration" content="PT1M33S">
        <meta itemprop="thumbnail" content="foo-fighters-interview-thumb.jpg"><object>
            <param>
             <embed type="application/x-shockwave-flash">
        </object> <span itemprop="description">Catch this exclusive interview with Dave Grohl and the Foo Fighters about their new album, Rope.</span>
        <h3>
            Comments:
        </h3>Excited about seeing them in concert next week. -Lawrence , Jan 23 I dig their latest single. -Mary, Jan 19
        <div itemprop="interactionStatistic" itemscope itemtype="https://schema.org/InteractionCounter">
            <meta itemprop="interactionType" content="https://schema.org/CommentAction">
            <meta itemprop="userInteractionCount" content="18">
        </div>Showing 1-2 of 18 comments. <a href="foofighters-comments">More</a>
        </div>
    <h2>
        Songs
    </h2>
    <div itemprop="track" itemscope itemtype="https://schema.org/MusicRecording">
        <span itemprop="name">Rope</span>
        <link itemprop="url" href="foo-fighters-rope.html">Length:
        <meta itemprop="duration" content="PT4M5S">4:05 - 14300 plays
        <div itemprop="interactionStatistic" itemscope itemtype="https://schema.org/InteractionCounter">
            <meta itemprop="interactionType" content="https://schema.org/ListenAction">
            <meta itemprop="userInteractionCount" content="14300">
        </div><a href="foo-fighters-rope-play.html" itemprop="audio">Play</a> <a href="foo-fighters-rope-buy.html" itemprop="offers">Buy</a> From album: <a href="foo-fighters-wasting-light.html" itemprop="inAlbum">Wasting Light</a>
    </div>
    <div itemprop="track" itemscope itemtype="https://schema.org/MusicRecording">
        <span itemprop="name">Everlong</span>
        <link itemprop="url" href="foo-fighters-everlong.html">Length:
        <meta itemprop="duration" content="PT6M33S">6:33 - 11700 plays
        <div itemprop="interactionStatistic" itemscope itemtype="https://schema.org/InteractionCounter">
            <meta itemprop="interactionType" content="https://schema.org/ListenAction">
            <meta itemprop="userInteractionCount" content="11700">
        </div><a href="foo-fighters-everlong-play.html" itemprop="audio">Play</a> <a href="foo-fighters-everlong-buy.html" itemprop="offers">Buy</a> From album: <a href="foo-fighters-color-and-shape.html" itemprop="inAlbum">The Color And The Shape</a>
    </div>
    <h2>
        Upcoming shows
    </h2>
    <div itemprop="event" itemscope itemtype="https://schema.org/Event">
        <a href="foo-fighters-may20-fedexforum" itemprop="url"><span itemprop="name">FedExForum</span></a> <span itemprop="location">Memphis, TN, US</span>
        <meta itemprop="startDate" content="2011-05-20">May 20 <a href="ticketmaster.com/foofighters/may20-2011" itemprop="offers">Buy tickets</a>
    </div>
    <div itemprop="event" itemscope itemtype="https://schema.org/Event">
        <a href="foo-fighters-may23-midamericacenter" itemprop="url"><span itemprop="name">Mid America Center</span></a> <span itemprop="location">Council Bluffs, IA, US</span>
        <meta itemprop="startDate" content="2011-05-23">May 23 <a href="ticketmaster.com/foofighters/may23-2011" itemprop="offers">Buy tickets</a>
    </div>
    <h2>
        <a href="foo-fighters-photos">28 Photos</a>
    </h2><a href="foofighters-1.jpg" itemprop="image"><img alt="Thumbnail and linked photo of Foo Fighters band" src="foofighters-thumb1.jpg"></a> <a href="foofighters-2.jpg" itemprop="image"><img alt="Thumbnail and linked photo of Foo Fighters band" src="foofighters-thumb2.jpg"></a> <a href="foofighters-3.jpg" itemprop="image"><img alt="Thumbnail and linked photo of Foo Fighters band" src="foofighters-thumb3.jpg"></a>
</div>
Example encoded as RDFa embedded in HTML.
<div vocab="https://schema.org/" typeof="MusicGroup">
    <h1 property="name">
        Foo Fighters
    </h1>
    <div property="subjectOf" typeof="VideoObject">
        <h2>
            Video: <span property="name">Interview with the Foo Fighters</span>
        </h2>
        <meta property="duration" content="PT1M33S">
        <meta property="thumbnail" content="foo-fighters-interview-thumb.jpg"><object>
            <param>
             <embed type="application/x-shockwave-flash">
        </object> <span property="description">Catch this exclusive interview with Dave Grohl and the Foo Fighters about their new album, Rope.</span>
        <h3>
            Comments:
        </h3>Excited about seeing them in concert next week. -Lawrence , Jan 23 I dig their latest single. -Mary, Jan 19
        <div property="interactionStatistic" typeof="https://schema.org/InteractionCounter">
            <meta property="interactionType" content="https://schema.org/CommentAction">
            <meta property="userInteractionCount" content="18">
        </div>Showing 1-2 of 18 comments. <a href="foofighters-comments">More</a>
    </div>
    <h2>
        Songs
    </h2>
    <div property="track" typeof="MusicRecording">
        <span property="name">Rope</span>
        <link property="url" href="foo-fighters-rope.html">Length:
        <meta property="duration" content="PT4M5S">4:05 - 14300 plays
        <div property="interactionStatistic" typeof="https://schema.org/InteractionCounter">
            <meta property="interactionType" content="https://schema.org/ListenAction">
            <meta property="userInteractionCount" content="14300">
        </div><a href="foo-fighters-rope-play.html" property="audio">Play</a> <a href="foo-fighters-rope-buy.html" property="offers">Buy</a> From album: <a href="foo-fighters-wasting-light.html" property="inAlbum">Wasting Light</a>
    </div>
    <div property="track" typeof="MusicRecording">
        <span property="name">Everlong</span>
        <link property="url" href="foo-fighters-everlong.html">Length:
        <meta property="duration" content="PT6M33S">6:33 - 11700 plays
        <div property="interactionStatistic" typeof="https://schema.org/InteractionCounter">
            <meta property="interactionType" content="https://schema.org/ListenAction">
            <meta property="userInteractionCount" content="11700">
        </div><a href="foo-fighters-everlong-play.html" property="audio">Play</a> <a href="foo-fighters-everlong-buy.html" property="offers">Buy</a> From album: <a href="foo-fighters-color-and-shape.html" property="inAlbum">The Color And The Shape</a>
    </div>
    <h2>
        Upcoming shows
    </h2>
    <div property="event" typeof="Event">
        <a href="foo-fighters-may20-fedexforum" property="url"><span property="name">FedExForum</span></a> <span property="location">Memphis, TN, US</span>
        <meta property="startDate" content="2011-05-20">May 20 <a href="ticketmaster.com/foofighters/may20-2011" property="offers">Buy tickets</a>
    </div>
    <div property="event" typeof="Event">
        <a href="foo-fighters-may23-midamericacenter" property="url"><span property="name">Mid America Center</span></a> <span property="location">Council Bluffs, IA, US</span>
        <meta property="startDate" content="2011-05-23">May 23 <a href="ticketmaster.com/foofighters/may23-2011" property="offers">Buy tickets</a>
    </div>
    <h2>
        <a href="foo-fighters-photos">28 Photos</a>
    </h2><a href="foofighters-1.jpg" property="image"><img alt="Thumbnail and linked photo of Foo Fighters band" src="foofighters-thumb1.jpg"></a> <a href="foofighters-2.jpg" property="image"><img alt="Thumbnail and linked photo of Foo Fighters band" src="foofighters-thumb2.jpg"></a> <a href="foofighters-3.jpg" property="image"><img alt="Thumbnail and linked photo of Foo Fighters band" src="foofighters-thumb3.jpg"></a>
</div>
Example encoded as JSON-LD in a HTML script tag.
<script type="application/ld+json">
{
    "@context": "https://schema.org",
    "@type": "MusicGroup",
    "event": [
        {
            "@type": "Event",
            "location": "Memphis, TN, US",
            "offers": "ticketmaster.com/foofighters/may20-2011",
            "startDate": "2011-05-20",
            "url": "foo-fighters-may20-fedexforum"
        },
        {
            "@type": "Event",
            "location": "Council Bluffs, IA, US",
            "offers": "ticketmaster.com/foofighters/may23-2011",
            "startDate": "2011-05-23",
            "url": "foo-fighters-may23-midamericacenter"
        }
    ],
    "image": [
        "foofighters-1.jpg",
        "foofighters-2.jpg",
        "foofighters-3.jpg"
    ],
    "name": "Foo Fighters",
    "track": [
        {
            "@type": "MusicRecording",
            "audio": "foo-fighters-rope-play.html",
            "duration": "PT4M5S",
            "inAlbum": "foo-fighters-wasting-light.html",
            "interactionStatistic": {
                "@type": "InteractionCounter",
                "interactionType": "https://schema.org/ListenAction",
                "userInteractionCount": "14300"
            },
            "name": "Rope",
            "offers": "foo-fighters-rope-buy.html",
            "url": "foo-fighters-rope.html"
        },
        {
            "@type": "MusicRecording",
            "audio": "foo-fighters-everlong-play.html",
            "duration": "PT6M33S",
            "inAlbum": "foo-fighters-color-and-shape.html",
            "name": "Everlong",
            "interactionStatistic": {
                "@type": "InteractionCounter",
                "interactionType": "https://schema.org/ListenAction",
                "userInteractionCount": "11700"
            },
            "offers": "foo-fighters-everlong-buy.html",
            "url": "foo-fighters-everlong.html"
        }
    ],
    "subjectOf": {
        "@type": "VideoObject",
        "description": "Catch this exclusive interview with Dave Grohl and the Foo Fighters about their new album, Rope.",
        "duration": "PT1M33S",
        "name": "Interview with the Foo Fighters",
        "thumbnail": "foo-fighters-interview-thumb.jpg",
        "interactionStatistic": {
            "@type": "InteractionCounter",
            "interactionType": "https://schema.org/CommentAction",
            "userInteractionCount": "18"
        }
    }
}
</script>
Structured representation of the JSON-LD example.