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

timeRequired

A Schema.org Property
Approximate or typical time it usually takes to work with or through the content of this work for the typical or target audience.

Values expected to be one of these types

Used on these types

Examples

Example 1
Copied
Example notes or example HTML without markup.
<div>
    <h1>The Declaration of Arbroath</h1>
    <p>A lesson plan for teachers with associated video.
       Typical length of lesson, 1 hour.
       Recommended for children aged 10-12 years old.
    </p>
    <p>Subject: Wars of Scottish independence</p>
    <p>Alignment to curriculum:</p>
    <ul>
        <li>England
            National Curriculum: KS 3 History: The middle ages (12th to 15th century)
        </li>
        <li>Scotland
            SCQF: Level 2
            Curriculum for Excellence: Social studies: people past events and societies
        </li>
    </ul>
    <p>Link to lesson plan: <a href="http://example.org/lessonplan">http://example.org/lessonplan</a></p>
    <video>
        <source src="http://example.org/movie.mp4" type="video/mp4" />
        Duration 03:12
    </video>
    <p>This example is based on <a href="http://www.bbc.co.uk/education/clips/z3sjtfr">Declaration of Arbroath</a> from BBC Bitesize</p>

</div>
Example encoded as Microdata embedded in HTML.
<div itemscope itemtype="https://schema.org/WebPage">
    <h1 itemprop="name">The Declaration of Arbroath</h1>
    <p>A <span itemprop="learningResourceType">lesson plan</span>
       for <span itemprop="audience"
                 itemscope itemtype="https://schema.org/EducationalAudience">
           <span itemprop="educationalRole">teacher</span></span>s with associated video.
       Typical length of lesson, <span itemprop="timeRequired" content="PT1H">1 hour</span>.
       Recommended for children aged <span itemprop="typicalAgeRange">10-12</span> years old.
    </p>
    <p>Subject: <span itemprop="about">Wars of Scottish independence</span></p>
    <p>Alignment to curriculum:</p>
    <ul>
        <li>England
            <span itemprop="educationalLevel"
                  itemscope itemtype="https://schema.org/DefinedTerm">
                <span itemprop="inDefinedTermSet"
                      itemscope
                      itemtype="https://schema.org/DefinedTermSet">
                  <span itemprop="name">The National Curriculum for England</span>:
                  <link itemprop="url" href="https://www.gov.uk/government/collections/national-curriculum" />

                </span>
                <span itemprop="name">Key Stage 3</span>
            </span>
            <span itemprop="educationalAlignment"
                  itemscope itemtype="https://schema.org/AlignmentObject">
                <meta itemprop="alignmentType" content="educationalSubject" />
                <meta itemprop="educationalFramework" content="The National Curriculum for England" />
                <span itemprop="targetName">History: The middle ages (12th to 15th century)</span>
                <link itemprop="targetUrl" href="http://example.org/ENC/subjects/3102">
            </span>
        </li>
        <li>Scotland
            <span itemprop="educationalLevel"
                  itemscope itemtype="https://schema.org/DefinedTerm">
                <span itemprop="inDefinedTermSet"
                      itemscope
                      itemtype="https://schema.org/DefinedTermSet">
                  <span itemprop="name">SCQF</span>
                  <link itemprop="url" href="https://scqf.org.uk/">
                </span>:
                <span itemprop="name">Level 2</span>
            </span>
            <span itemprop="educationalAlignment"
                  itemscope itemtype="https://schema.org/AlignmentObject">
                <meta itemprop="alignmentType" content="educationalSubject" />
                <span itemprop="educationalFramework"> Curriculum for Excellence</span>:
                <span itemprop="targetName">Social studies: people past events and societies</span>
                <link itemprop="targetUrl" href="http://example.org/CFE/subjects/3362">
            </span>
        </li>
    </ul>
    <p>Link to lesson plan: <a itemprop="url" href="http://example.org/lessonplan">http://example.org/lessonplan</a></p>
    <video itemprop="video" itemscope itemtype="https://schema.org/VideoObject">
        <source itemprop="url" src="http://example.org/movie.mp4" type="video/mp4">
        <span itemprop="name">Video Title</span>
        <span itemprop="description">Video description</span>
        <span itemprop="uploadDate">2000-01-01</span>
        <img itemprop="thumbnailUrl" src="http://example.org/thubnail.mp4" alt="thumbnail" >
        Duration: <span itemprop="duration" content="PT3M12S">03:12</span>
    </video>
    <p>This example is based on <a itemprop="isBasedOn" href="http://www.bbc.co.uk/education/clips/z3sjtfr">Declaration of Arbroath</a> from BBC Bitesize</p>
</div>
Example encoded as RDFa embedded in HTML.
<div vocab="https://schema.org/" typeof="WebPage">
    <h1 property="name">The Declaration of Arbroath</h1>
    <p>A <span property="learningResourceType">lesson plan</span>
       for <span rel="audience"
                 typeof="EducationalAudience">
           <span property="educationalRole">teacher</span></span>s with associated video.
       Typical length of lesson, <span property="timeRequired" content="PT1H">1 hour</span>.
       Recommended for children aged <span property="typicalAgeRange">10-12</span> years old.
    </p>
    <p>Subject: <span property="about">Wars of Scottish independence</span></p>
    <p>Alignment to curriculum:</p>
    <ul>
        <li>England
            <span rel="educationalLevel"
                  typeof="https://schema.org/DefinedTerm">
                <span property="inDefinedTermSet"
                   typeof="https://schema.org/DefinedTermSet">
                  <span property="name">The National Curriculum for England</span>:
                  <link property="url" href="https://www.gov.uk/government/collections/national-curriculum"/>
                </span>:
                <span property="name">KS 3</span>
            </span>
            <span rel="educationalAlignment"
                  typeof="https://schema.org/AlignmentObject">
                <meta property="alignmentType" content="educationalSubject" />
                <meta property="educationalFramework" content="The National Curriculum for England" />
                <span property="targetName">History: The middle ages (12th to 15th century)</span>
                <link property="targetUrl" href="http://example.org/ENC/subjects/3102" />
            </span>
        </li>
        <li>Scotland
            <span rel="educationalLevel"
                typeof="https://schema.org/DefinedTerm">
              <span property="inDefinedTermSet"
                typeof="https://schema.org/DefinedTermSet" >
                <span property="name">SCQF</span>
                <link property="url" href="https://scqf.org.uk/">
              </span>:
              <span property="name">Level 2</span>
            </span>
            <span rel="educationalAlignment"
                  typeof="https://schema.org/AlignmentObject">
                <meta property="alignmentType" content="educationalSubject" />
                <span property="educationalFramework"> Curriculum for Excellence</span>:
                <span property="targetName">Social studies: people past events and societies</span>
                <link property="targetUrl" href="http://example.org/CFE/subjects/3362" />
            </span>
        </li>
    </ul>
    <p>Link to lesson plan: <a property="url" href="http://example.org/lessonplan">http://example.org/lessonplan</a></p>
    <video rel="video" typeof="https://schema.org/VideoObject">
        <source property="url" src="http://example.org/movie.mp4" type="video/mp4" />
        <span property="name">Video Title</span>
        <span property="description">Video description</span>
        <span property="uploadDate">2000-01-01</span>
        <img property="thumbnailUrl" src="http://example.org/thubnail.mp4" alt="thumbnail" />
        Duration: <span property="duration" content="PT3M12S">03:12</span>
    </video>
    <p>This example is based on <a property="isBasedOn" href="http://www.bbc.co.uk/education/clips/z3sjtfr">Declaration of Arbroath</a> from BBC Bitesize</p>
</div>
Example encoded as JSON-LD in a HTML script tag.
<script type="application/ld+json">

{
  "@context":  "https://schema.org/",
  "@type": "WebPage",
  "name": "The Declaration of Arbroath",
  "about": "Wars of Scottish independence",
  "learningResourceType": "lesson plan",
  "timeRequired": "PT1H",
  "typicalAgeRange": "10-12",
  "audience": {
      "@type": "EducationalAudience",
      "educationalRole": "teacher"
  },
  "educationalAlignment": [
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "educationalFramework": " Curriculum for Excellence",
      "targetName": "Social studies: people past events and societies",
      "targetUrl": "http://example.org/CFE/subjects/3362"
    },
    {
      "@type": "AlignmentObject",
      "alignmentType": "educationalSubject",
      "educationalFramework": "The National Curriculum for England",
      "targetName": "History: The middle ages (12th to 15th century)",
      "targetUrl" : "http://example.org/ENC/subjects/3102"
    }
  ],
  "educationalLevel": [
    {
      "@type": "DefinedTerm",
      "name": "Level 2",
      "inDefinedTermSet": {
	    "@type": "DefinedTermSet",
        "name": "SCQF",
        "url": "https://scqf.org.uk/"
      }
    },
    {
      "@type": "DefinedTerm",
      "name": "KS 3",
      "inDefinedTermSet": {
	    "@type": "DefinedTermSet",
        "name": "The National Curriculum for England",
        "url": "https://www.gov.uk/government/collections/national-curriculum"
      }
    }
  ],
  "url" : "http://example.org/lessonplan",

  "video": {
    "@type": "VideoObject",
    "description": "Video description",
    "duration": "PT3M12S",
    "name": "Video Title",
    "thumbnailUrl": "http://example.org/thubnail.mp4",
    "uploadDate": "2000-01-01",
    "url" : "http://example.org/movie.mp4"
  },
  "isBasedOn": "http://www.bbc.co.uk/education/clips/z3sjtfr"
}
</script>
Structured representation of the JSON-LD example.