TVSeries - schema.org

# schema.org

- Documentation
- Schemas
- Home

# TVSeries

#### Thing > CreativeWork > CreativeWorkSeries > TVSeries
Thing > CreativeWork > TVSeries

CreativeWorkSeries dedicated to TV broadcast and associated online delivery.
Usage: Between 1000 and 10,000 domains

Property | Expected Type | Description
--- | --- | ---
[more...]

- Leave public feedback on this term 💬
- Check for open issues.
- 'TVSeries' is mentioned in layer: core

Properties from TVSeries
`actor` | Person | An actor, e.g. in tv, radio, movie, video games etc., or in an event. Actors can be associated with individual items or with a series, episode, clip. Supersedes actors.
`containsSeason` | CreativeWorkSeason | A season that is part of the media series. Supersedes season.
`countryOfOrigin` | Country | The country of the principal offices of the production company or individual responsible for the movie or program.
`director` | Person | A director of e.g. tv, radio, movie, video gaming etc. content, or of an event. Directors can be associated with individual items or with a series, episode, clip. Supersedes directors.
`episode` | Episode | An episode of a tv, radio or game media within a series or season. Supersedes episodes.
`musicBy` | MusicGroup or Person | The composer of the soundtrack.
`numberOfEpisodes` | Integer | The number of episodes in this season or series.
`numberOfSeasons` | Integer | The number of seasons in this series.
`productionCompany` | Organization | The production company or studio responsible for the item e.g. series, video game, episode etc.
`trailer` | VideoObject | The trailer of a movie or tv/radio series, season, episode, etc.
Properties from CreativeWorkSeries
`endDate` | Date | The end date and time of the item (in ISO 8601 date format).
`startDate` | Date | The start date and time of the item (in ISO 8601 date format).
Properties from CreativeWork
`about` | Thing | The subject matter of the content.
`accessibilityAPI` | Text | Indicates that the resource is compatible with the referenced accessibility API (WebSchemas wiki lists possible values).
`accessibilityControl` | Text | Identifies input methods that are sufficient to fully control the described resource (WebSchemas wiki lists possible values).
`accessibilityFeature` | Text | Content features of the resource, such as accessible media, alternatives and supported enhancements for accessibility (WebSchemas wiki lists possible values).
`accessibilityHazard` | Text | A characteristic of the described resource that is physiologically dangerous to some users. Related to WCAG 2.0 guideline 2.3 (WebSchemas wiki lists possible values).
`accountablePerson` | Person | Specifies the Person that is legally accountable for the CreativeWork.
`aggregateRating` | AggregateRating | The overall rating, based on a collection of reviews or ratings, of the item.
`alternativeHeadline` | Text | A secondary title of the CreativeWork.
`associatedMedia` | MediaObject | A media object that encodes this CreativeWork. This property is a synonym for encoding.
`audience` | Audience | An intended audience, i.e. a group for whom something was created. Supersedes serviceAudience.
`audio` | AudioObject | An embedded audio object.
`author` | Organization or Person | The author of this content. Please note that author is special in that HTML 5 provides a special mechanism for indicating authorship via the rel tag. That is equivalent to this and may be used interchangeably.
`award` | Text | An award won by or for this item. Supersedes awards.
`character` | Person | Fictional person connected with a creative work.
`citation` | CreativeWork or Text | A citation or reference to another creative work, such as another publication, web page, scholarly article, etc.
`comment` | Comment | Comments, typically from users.
`commentCount` | Integer | The number of comments this CreativeWork (e.g. Article, Question or Answer) has received. This is most applicable to works published in Web sites with commenting system; additional comments may exist elsewhere.
`contentLocation` | Place | The location depicted or described in the content. For example, the location in a photograph or painting.
`contentRating` | Text | Official rating of a piece of content—for example,'MPAA PG-13'.
`contributor` | Organization or Person | A secondary contributor to the CreativeWork or Event.
`copyrightHolder` | Organization or Person | The party holding the legal copyright to the CreativeWork.
`copyrightYear` | Number | The year during which the claimed copyright for the CreativeWork was first asserted.
`creator` | Organization or Person | The creator/author of this CreativeWork. This is the same as the Author property for CreativeWork.
`dateCreated` | Date or DateTime | The date on which the CreativeWork was created or the item was added to a DataFeed.
`dateModified` | Date or DateTime | The date on which the CreativeWork was most recently modified or when the item's entry was modified within a DataFeed.
`datePublished` | Date | Date of first broadcast/publication.
`discussionUrl` | URL | A link to the page containing the comments of the CreativeWork.
`editor` | Person | Specifies the Person who edited the CreativeWork.
`educationalAlignment` | AlignmentObject | An alignment to an established educational framework.
`educationalUse` | Text | The purpose of a work in the context of education; for example, 'assignment', 'group work'.
`encoding` | MediaObject | A media object that encodes this CreativeWork. This property is a synonym for associatedMedia. Supersedes encodings.
`exampleOfWork` | CreativeWork | A creative work that this work is an example/instance/realization/derivation of. Inverse property: workExample.
`fileFormat` | Text | Media type (aka MIME format, see IANA site) of the content e.g. application/zip of a SoftwareApplication binary. In cases where a CreativeWork has several media type representations, 'encoding' can be used to indicate each MediaObject alongside particular fileFormat information.
`genre` | Text | Genre of the creative work or group.
`hasPart` | CreativeWork | Indicates a CreativeWork that is (in some sense) a part of this CreativeWork. Inverse property: isPartOf.
`headline` | Text | Headline of the article.
`inLanguage` | Language or Text | The language of the content or performance or used in an action. Please use one of the language codes from the IETF BCP 47 standard. See also availableLanguage. Supersedes language.
`interactionStatistic` | InteractionCounter | The number of interactions for the CreativeWork using the WebSite or SoftwareApplication. The most specific child type of InteractionCounter should be used. Supersedes interactionCount.
`interactivityType` | Text | The predominant mode of learning supported by the learning resource. Acceptable values are 'active', 'expositive', or 'mixed'.
`isBasedOn` | CreativeWork or Product or URL | A resource that was used in the creation of this resource. This term can be repeated for multiple sources. For example, http://example.com/great-multiplication-intro.html. Supersedes isBasedOnUrl.
`isFamilyFriendly` | Boolean | Indicates whether this content is family friendly.
`isPartOf` | CreativeWork | Indicates a CreativeWork that this CreativeWork is (in some sense) part of. Inverse property: hasPart.
`keywords` | Text | Keywords or tags used to describe this content. Multiple entries in a keywords list are typically delimited by commas.
`learningResourceType` | Text | The predominant type or kind characterizing the learning resource. For example, 'presentation', 'handout'.
`license` | CreativeWork or URL | A license document that applies to this content, typically indicated by URL.
`locationCreated` | Place | The location where the CreativeWork was created, which may not be the same as the location depicted in the CreativeWork.
`mainEntity` | Thing | Indicates the primary entity described in some page or other CreativeWork. Inverse property: mainEntityOfPage.
`mentions` | Thing | Indicates that the CreativeWork contains a reference to, but is not necessarily about a concept.
`offers` | Offer | An offer to provide this item—for example, an offer to sell a product, rent the DVD of a movie, perform a service, or give away tickets to an event.
`position` | Integer or Text | The position of an item in a series or sequence of items.
`producer` | Organization or Person | The person or organization who produced the work (e.g. music album, movie, tv/radio series etc.).
`provider` | Organization or Person | The service provider, service operator, or service performer; the goods producer. Another party (a seller) may offer those services or goods on behalf of the provider. A provider may also serve as the seller. Supersedes carrier.
`publication` | PublicationEvent | A publication event associated with the item.
`publisher` | Organization | The publisher of the creative work.
`publishingPrinciples` | URL | Link to page describing the editorial principles of the organization primarily responsible for the creation of the CreativeWork.
`recordedAt` | Event | The Event where the CreativeWork was recorded. The CreativeWork may capture all or part of the event. Inverse property: recordedIn.
`releasedEvent` | PublicationEvent | The place and time the release was issued, expressed as a PublicationEvent.
`review` | Review | A review of the item. Supersedes reviews.
`schemaVersion` | Text or URL | Indicates (by URL or string) a particular version of a schema used in some CreativeWork. For example, a document could declare a schemaVersion using an URL such as http://schema.org/version/2.0/ if precise indication of schema version was required by some application.
`sourceOrganization` | Organization | The Organization on whose behalf the creator was working.
`text` | Text | The textual content of this CreativeWork.
`thumbnailUrl` | URL | A thumbnail image relevant to the Thing.
`timeRequired` | Duration | Approximate or typical time it takes to work with or through this learning resource for the typical intended target audience, e.g. 'P30M', 'P1H25M'.
`translator` | Organization or Person | Organization or person who adapts a creative work to different languages, regional differences and technical requirements of a target market, or that translates during some event.
`typicalAgeRange` | Text | The typical expected age range, e.g. '7-9', '11-'.
`version` | Number | The version of the CreativeWork embodied by a specified resource.
`video` | VideoObject | An embedded video object.
`workExample` | CreativeWork | Example/instance/realization/derivation of the concept of this creative work. eg. The paperback edition, first edition, or eBook. Inverse property: exampleOfWork.
Properties from Thing
`additionalType` | URL | An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. In RDFa syntax, it is better to use the native RDFa syntax - the 'typeof' attribute - for multiple types. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally.
`alternateName` | Text | An alias for the item.
`description` | Text | A description of the item.
`disambiguatingDescription` | Text | A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
`image` | ImageObject or URL | An image of the item. This can be a URL or a fully described ImageObject.
`mainEntityOfPage` | CreativeWork or URL | Indicates a page (or other CreativeWork) for which this thing is the main entity being described. See background notes for details. Inverse property: mainEntity.
`name` | Text | The name of the item.
`potentialAction` | Action | Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.
`sameAs` | URL | URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Freebase page, or official website.
`url` | URL | URL of the item.

#### Available properties in extensions

- For CreativeWork in the bib extension: publisherImprint, translationOfWork, workTranslation
- For CreativeWork in the pending extension: accessMode, accessModeSufficient, accessibilitySummary, contentReferenceTime

Examples
Example 1
Without Markup Microdata RDFa JSON-LD

    Grey's Anatomy is a medical drama television series created by Shonda Rimes
    Starring:
    Justin Chambers
    Jessica Capshaw
    Season 1 - May 22, 2005
    Season 2 - May 14, 2006

    <div itemscope itemtype="http://schema.org/TVSeries">
     <span itemprop="name">Greys Anatomy</span> is a medical drama television series created by
     <div  itemprop="author" itemscope itemtype="http://schema.org/Person">
       <span itemprop="name">Shonda Rimes</span>
     </div>
     Starring:
     <div itemprop="actor" itemscope itemtype="http://schema.org/Person">
       <span itemprop="name">Justin Chambers</span>
     </div>
     <div itemprop="actor" itemscope itemtype="http://schema.org/Person">
       <span itemprop="name">Jessica Capshaw</span>
     </div>
     <div itemprop="containsSeason" itemscope itemtype="http://schema.org/TVSeason">
       <span itemprop="name">Season 1</span> -
       <meta itemprop="numberOfEpisodes" content="14"/>
       <meta itemprop="datePublished" content="2005-05-22">May 22, 2005
     </div>
     <div itemprop="containsSeason" itemscope itemtype="http://schema.org/TVSeason">
       <span itemprop="name">Season 2</span> -
       <meta itemprop="numberOfEpisodes" content="27"/>
       <meta itemprop="datePublished" content="2006-05-14">May 14, 2006
       <div itemprop="episode" itemscope itemtype="http://schema.org/TVEpisode">
         <span itemprop="name">Episode 1</span> -
         <meta itemprop="episodeNumber" content="1"/>
       </div>
     </div>
    </div>

    <div vocab="http://schema.org/" typeof="TVSeries">
     <span property="name">Greys Anatomy</span> is a medical drama television series created by
     <div  property="author" typeof="Person">
       <span property="name">Shonda Rimes</span>
     </div>
     Starring:
     <div property="actor" typeof="Person">
       <span property="name">Justin Chambers</span>
     </div>
     <div property="actor" typeof="Person">
       <span property="name">Jessica Capshaw</span>
     </div>
     <div property="containsSeason" typeof="TVSeason">
       <span property="name">Season 1</span> -
       <meta property="numberOfEpisodes" content="14"/>
       <meta property="datePublished" content="2005-05-22">May 22, 2005
     </div>
     <div property="containsSeason" typeof="TVSeason">
       <span property="name">Season 2</span> -
       <meta property="numberOfEpisodes" content="27"/>
       <meta property="datePublished" content="2006-05-14">May 14, 2006
       <div property="episode" typeof="TVEpisode">
         <span property="name">Episode 1</span> -
         <meta property="episodeNumber" content="1"/>
       </div>
     </div>
    </div>

    <script type="application/ld+json">
    {
      "@context": "http://schema.org",
      "@type": "TVSeries",
      "actor": [
        {
          "@type": "Person",
          "name": "Justin Chambers"
        },
        {
          "@type": "Person",
          "name": "Jessica Capshaw"
        }
      ],
      "author": {
        "@type": "Person",
        "name": "Shonda Rimes"
      },
      "name": "Greys Anatomy",
      "containsSeason": [
        {
          "@type": "TVSeason",
          "datePublished": "2005-05-22",
          "name": "Season 1",
          "numberOfEpisodes": "14"
        },
        {
          "@type": "TVSeason",
          "datePublished": "2006-05-14",
          "episode": {
            "@type": "TVEpisode",
            "episodeNumber": "1",
            "name": "Episode 1"
          },
          "name": "Season 2",
          "numberOfEpisodes": "27"
        }
      ]
    }
    </script>

Example 2
Without Markup Microdata RDFa JSON-LD

    <div>
     <a href="http://www.bbc.co.uk/programmes/b006q2x0">Doctor Who</a>,
     <a href="http://www.bbc.co.uk/programmes/b00rs69w">Series 5</a>,
     <a href="http://www.bbc.co.uk/programmes/b00sj9sq">The Hungry Earth</a>, episode 8,
     broadcast on BBC One at 18:15, 22nd of May 2010, available on
     <a href="http://www.bbc.co.uk/iplayer/b00sj9sq">BBC iPlayer</a> from 19:45
     on the 2nd of June until the 9th.
    </div>

    <div itemscope itemtype="http://schema.org/TVSeries">
      <a itemprop="url" href="http://www.bbc.co.uk/programmes/b006q2x0">
       <span itemprop="name">Doctor Who</span></a>,
      <div itemprop="containsSeason" itemscope itemtype="http://schema.org/TVSeason">
        <a itemprop="url" href="http://www.bbc.co.uk/programmes/b00rs69w">
         <span itemprop="name">Series 5</span></a>,
        <div itemprop="episode" itemscope itemtype="http://schema.org/TVEpisode">
          <a itemprop="url" href="http://www.bbc.co.uk/programmes/b00sj9sq">
           <span itemprop="name">The Hungry Earth</span></a>,
          episode <span itemprop="position">8</span>, broadcast on
          <div itemprop="publication" itemscope itemtype="http://schema.org/BroadcastEvent">
            <div itemprop="publishedOn" itemscope itemtype="http://schema.org/BroadcastService">
              <a itemprop="url" href="http://www.bbc.co.uk/bbcone"><span itemprop="name">BBC One</span></a>
            </div> at
            <span itemprop="startDate"
              content="2010-05-22T18:15:00+01:00">18:15, 22nd of May 2010</span>
          </div>,
          available on
          <div itemprop="video" itemscope itemtype="http://schema.org/VideoObject">
            <a itemprop="url" href="http://www.bbc.co.uk/iplayer/episode/b00sj9sq">BBC iPlayer</a>
          </div> from
          <div itemprop="publication" itemscope itemtype="http://schema.org/OnDemandEvent">
            <span itemprop="startDate"
             content="2012-06-02T19:45:00+01:00">19:45 on the 2nd of June</span> until the
            <span itemprop="endDate" content="2012-06-09T19:44:00+01:00">9th</span>.
          </div>
        </div>
      </div>
    </div>

    <div vocab="http://schema.org/" typeof="TVSeries">
      <a property="url" href="http://www.bbc.co.uk/programmes/b006q2x0">
       <span property="name">Doctor Who</span></a>,
      <div property="containsSeason" typeof="TVSeason">
        <a property="url" href="http://www.bbc.co.uk/programmes/b00rs69w">
         <span property="name">Series 5</span></a>,
        <div property="episode" typeof="TVEpisode">
          <a property="url" href="http://www.bbc.co.uk/programmes/b00sj9sq">
           <span property="name">The Hungry Earth</span></a>,
          episode <span property="position">8</span>, broadcast on
          <div property="publication" typeof="BroadcastEvent">
            <div property="publishedOn" typeof="BroadcastService">
              <a property="url" href="http://www.bbc.co.uk/bbcone"><span property="name">BBC One</span></a>
            </div> at
            <span property="startDate"
              content="2010-05-22T18:15:00+01:00">18:15, 22nd of May 2010</span>
          </div>,
          available on
          <div property="video" typeof="VideoObject">
            <a property="url" href="http://www.bbc.co.uk/iplayer/episode/b00sj9sq">BBC iPlayer</a>
          </div> from
          <div property="publication" typeof="OnDemandEvent">
            <span property="startDate"
             content="2012-06-02T19:45:00+01:00">19:45 on the 2nd of June</span> until the
            <span property="endDate" content="2012-06-09T19:44:00+01:00">9th</span>.
          </div>
        </div>
      </div>
    </div>

    <script type="application/ld+json">
    {
      "@context": "http://schema.org",
      "@type": "TVSeries",
      "containsSeason": {
        "@type": "TVSeason",
        "episode": {
          "@type": "TVEpisode",
          "position": "8",
          "publication": [
            {
              "@type": "BroadcastEvent",
              "publishedOn": {
                "@type": "BroadcastService",
                "url": "http://www.bbc.co.uk/bbcone"
              },
              "startDate": "18:15, 22nd of May 2010"
            },
            {
              "@type": "OnDemandEvent",
              "endDate": "9th",
              "startDate": "19:45 on the 2nd of June"
            }
          ],
          "url": "http://www.bbc.co.uk/programmes/b00sj9sq",
          "video": {
            "@type": "VideoObject",
            "url": "http://www.bbc.co.uk/iplayer/episode/b00sj9sq"
          }
        },
        "url": "http://www.bbc.co.uk/programmes/b00rs69w"
      },
      "url": "http://www.bbc.co.uk/programmes/b006q2x0"
    }
    </script>

Schema Version 3.0