# timeRequired - Schema.org Property

> Source: https://schema.org/timeRequired
> Extracted: 2026-02-16T22:02:31.041Z

---

**Note**: You are viewing the development version of [Schema.org](https://schema.org/). See [how we work](https://schema.org/docs/howwework.html) for more details.

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

`-   [Duration](https://schema.org/Duration "Duration")`

### Examples

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](https://en.wikipedia.org/wiki/Microdata_\(HTML\)) 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](https://en.wikipedia.org/wiki/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](https://en.wikipedia.org/wiki/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.