--- title: "Program Types" slug: "program-types" tags: ["Metadata"] updated: 2025-08-13T19:25:48Z published: 2025-08-13T19:25:48Z canonical: "docs.developer.comcast.com/program-types" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.developer.comcast.com/llms.txt > Use this file to discover all available pages before exploring further. # Program Types When you integrate your metadata, you need to know what types of programming you have on your App, because each type supports different fields. There are several main program types: - **Movie:** A film that is primarily theatrical, made-for-TV, direct-to-video, or streaming-first. - **SeriesMaster:** A top-level ID for sets of two or more programs, which are typically episodes but can also be SportingEvent or Other; SeriesMaster also stores data that applies to the entire series. - **TvSeason:** A season of episodes within a TV series. - **Episode:** An individual airing of a TV series, linked to a SeriesMaster, typically ordered through episode number and linked to a TvSeason. - **SportingEvent:** An athletic event or other team-vs-team game, not including pre/post-game shows, documentaries, or specials. - **Other:** A one-time-only (OTO) program that is not an Episode, Movie, SportingEvent, or SeriesMaster (for example, the Oscars). There are also short form program types that are tied to longer content. Some short form types include: - **Preview:** A collection of scenes for viewers to see what a piece of content is about, such as a teaser or trailer for an upcoming movie. - **Extra:** An additional or bonus piece of content, such as a behind-the-scenes interview or deleted scene for a program. > **Note:** There is overlap in which types support specific fields, but not all types support all fields, and no type supports every field. The following section provides lists of the fields used for each specific program type, with links to descriptions of each field. To view the list of all fields regardless of program type, see the full [Metadata Specifications](/docs/metadata-specifications). To view examples of the program types, see the [Examples](/docs/program-types#examples) section below. --- ## Movie ****General Fields**** - [title](/docs/metadata-specifications#title) - [description](/docs/metadata-specifications#description) - [shortDescription](/docs/metadata-specifications#shortdescription) - [mediumDescription](/docs/metadata-specifications#mediumdescription) - [longDescription](/docs/metadata-specifications#longdescription) - [pubDate](/docs/metadata-specifications#pubdate) - [releaseYear](/docs/metadata-specifications#releaseyear) - [dcterms:valid](/docs/metadata-specifications#dctermsvalid) - [contentRights](/docs/metadata-specifications#contentrights) - [contentProviderName](/docs/metadata-specifications#contentprovidername) - [distributionRights](/docs/metadata-specifications#distributionrights) - [restriction](/docs/metadata-specifications#restriction) - [distributor](/docs/metadata-specifications#distributor) - [languageDetails](/docs/metadata-specifications#languagedetails) - [entityType](/docs/metadata-specifications#entitytype) - [workflowPolicy](/docs/metadata-specifications#workflowpolicy) - [videoAssetId](/docs/metadata-specifications#videoassetid) - [programVariantId](/docs/metadata-specifications#programvariantid) - [durableAppId](/docs/metadata-specifications#durableappid) - [sportsSubtitle](/docs/metadata-specifications#sportssubtitle) - [entityReference](/docs/metadata-specifications#entityreference) - [tagReference](/docs/metadata-specifications#tagreference) - [brand](/docs/metadata-specifications#brand) - [externalAssetId](/docs/metadata-specifications#externalassetid) - [externalEntityId](/docs/metadata-specifications#externalentityid) - [creditAssociation](/docs/metadata-specifications#creditassociation) - [personReference](/docs/metadata-specifications#personreference) - [partReference](/docs/metadata-specifications#partreference) - [companyReference](/docs/metadata-specifications#companyreference) - [liveWindowEnd](/docs/metadata-specifications#livewindowend) - [visibilityDate](/docs/metadata-specifications#visibilitydate) - [displayStartDate](/docs/metadata-specifications#displaystartdate) - [availabilityStatus](/docs/metadata-specifications#availabilitystatus) - [airingType](/docs/metadata-specifications#airingtype) - [subjectToCoppa](/docs/metadata-specifications#subjecttocoppa) - [ivod](/docs/metadata-specifications#ivod) - [listingStartTime](/docs/metadata-specifications#listingstarttime) - [stationReference](/docs/metadata-specifications#stationreference) - [eventTournamentReference](/docs/metadata-specifications#eventtournamentreference) - [sportsConferenceReference](/docs/metadata-specifications#sportsconferencereference) - [timeSlice](/docs/metadata-specifications#timeslice) - [timeMarker](/docs/metadata-specifications#timemarker) - [videoSource](/docs/metadata-specifications#videosource) - [sourcePart](/docs/metadata-specifications#sourcepart) - [breakpoint](/docs/metadata-specifications#breakpoint) - [media:status](/docs/metadata-specifications#mediastatus) - [media:group](/docs/metadata-specifications#mediagroup) - [media:content](/docs/metadata-specifications#mediacontent) - [media:rating](/docs/metadata-specifications#mediarating) - [media:thumbnail](/docs/metadata-specifications#mediathumbnail) - [media:keywords](/docs/metadata-specifications#mediakeywords) - [media:copyright](/docs/metadata-specifications#mediacopyright) ****Content Fields**** - [audioTrack](/docs/metadata-specifications#audiotrack) - [subtitle](/docs/metadata-specifications#subtitle) - [videoCodec](/docs/metadata-specifications#videocodec) - [videoQualityVariant](/docs/metadata-specifications#videoqualityvariant) - [audioCodec](/docs/metadata-specifications#audiocodec) - [transport](/docs/metadata-specifications#transport) - [protectionMethod](/docs/metadata-specifications#protectionmethod) - [protectionKey](/docs/metadata-specifications#protectionkey) - [container](/docs/metadata-specifications#container) - [protectionScheme](/docs/metadata-specifications#protectionscheme) - [protectionSystem](/docs/metadata-specifications#protectionsystem) - [appStartMode](/docs/metadata-specifications#appstartmode) - [appMetadata](/docs/metadata-specifications#appmetadata) - [optimizedFor](/docs/metadata-specifications#optimizedfor) - [adCompatibility](/docs/metadata-specifications#adcompatibility) - [adInstructions](/docs/metadata-specifications#adinstructions) - [targetPlatforms](/docs/metadata-specifications#targetplatforms) - [publicationStatus](/docs/metadata-specifications#publicationstatus) - [packageType](/docs/metadata-specifications#packagetype) - [watermarkEndDate](/docs/metadata-specifications#watermarkenddate) - [adminTag](/docs/metadata-specifications#admintag) - [categoryPath](/docs/metadata-specifications#categorypath) - [originalHeight](/docs/metadata-specifications#originalheight) - [originalWidth](/docs/metadata-specifications#originalwidth) - [watermark](/docs/metadata-specifications#watermark) - [trackAssignment](/docs/metadata-specifications#trackassignment) ****Distribution Rights Fields**** - [valid](/docs/metadata-specifications#valid) - [contentCatalog](/docs/metadata-specifications#contentcatalog) - [contentCatalogs](/docs/metadata-specifications#contentcatalogs) - [contentClass](/docs/metadata-specifications#contentclass) - [contentTier](/docs/metadata-specifications#contenttier) - [playRegions](/docs/metadata-specifications#playregions) - [playRegion](/docs/metadata-specifications#playregion) - [downloadable](/docs/metadata-specifications#downloadable) - [streamable](/docs/metadata-specifications#streamable) - [restriction](/docs/metadata-specifications#restriction) ****Content Rights Fields** **(legacy)**** - [restriction](/docs/metadata-specifications#restriction-legacy) - [segment](/docs/metadata-specifications#segment-legacy) - [proposition](/docs/metadata-specifications#proposition-legacy) - [windowType](/docs/metadata-specifications#windowtype-legacy) - [windowMode](/docs/metadata-specifications#windowmode-legacy) - [valid](/docs/metadata-specifications#valid-legacy) - [downloadable](/docs/metadata-specifications#downloadable-legacy) - [streamable](/docs/metadata-specifications#streamable-legacy) ## SeriesMaster ****General Fields**** - [title](/docs/metadata-specifications#title) - [description](/docs/metadata-specifications#description) - [shortDescription](/docs/metadata-specifications#shortdescription) - [mediumDescription](/docs/metadata-specifications#mediumdescription) - [longDescription](/docs/metadata-specifications#longdescription) - [pubDate](/docs/metadata-specifications#pubdate) - [releaseYear](/docs/metadata-specifications#releaseyear) - [languageDetails](/docs/metadata-specifications#languagedetails) - [entityType](/docs/metadata-specifications#entitytype) - [workflowPolicy](/docs/metadata-specifications#workflowpolicy) - [programVariantId](/docs/metadata-specifications#programvariantid) - [seriesAssetId](/docs/metadata-specifications#seriesassetid) - [entityReference](/docs/metadata-specifications#entityreference) - [tagReference](/docs/metadata-specifications#tagreference) - [creditAssociation](/docs/metadata-specifications#creditassociation) - [personReference](/docs/metadata-specifications#personreference) - [partReference](/docs/metadata-specifications#partreference) - [media:status](/docs/metadata-specifications#mediastatus) ## TvSeason ****General Fields**** - [title](/docs/metadata-specifications#title) - [description](/docs/metadata-specifications#description) - [languageDetails](/docs/metadata-specifications#languagedetails) - [entityType](/docs/metadata-specifications#entitytype) - [workflowPolicy](/docs/metadata-specifications#workflowpolicy) - [seasonAssetId](/docs/metadata-specifications#seasonassetid) - [entityReference](/docs/metadata-specifications#entityreference) - [seasonNumber](/docs/metadata-specifications#seasonnumber) - [media:status](/docs/metadata-specifications#mediastatus) ## Episode ****General Fields**** - [title](/docs/metadata-specifications#title) - [description](/docs/metadata-specifications#description) - [shortDescription](/docs/metadata-specifications#shortdescription) - [mediumDescription](/docs/metadata-specifications#mediumdescription) - [longDescription](/docs/metadata-specifications#longdescription) - [pubDate](/docs/metadata-specifications#pubdate) - [releaseYear](/docs/metadata-specifications#releaseyear) - [dcterms:valid](/docs/metadata-specifications#dctermsvalid) - [contentRights](/docs/metadata-specifications#contentrights) - [contentProviderName](/docs/metadata-specifications#contentprovidername) - [distributionRights](/docs/metadata-specifications#distributionrights) - [restriction](/docs/metadata-specifications#restriction) - [distributor](/docs/metadata-specifications#distributor) - [languageDetails](/docs/metadata-specifications#languagedetails) - [entityType](/docs/metadata-specifications#entitytype) - [videoAssetId](/docs/metadata-specifications#videoassetid) - [programVariantId](/docs/metadata-specifications#programvariantid) - [durableAppId](/docs/metadata-specifications#durableappid) - [seriesTitle](/docs/metadata-specifications#seriestitle) - [entityReference](/docs/metadata-specifications#entityreference) - [tagReference](/docs/metadata-specifications#tagreference) - [brand](/docs/metadata-specifications#brand) - [episodeNumber](/docs/metadata-specifications#episodenumber) - [seasonNumber](/docs/metadata-specifications#seasonnumber) - [externalAssetId](/docs/metadata-specifications#externalassetid) - [externalEntityId](/docs/metadata-specifications#externalentityid) - [externalSeriesId](/docs/metadata-specifications#externalseriesid) - [creditAssociation](/docs/metadata-specifications#creditassociation) - [personReference](/docs/metadata-specifications#personreference) - [partReference](/docs/metadata-specifications#partreference) - [companyReference](/docs/metadata-specifications#companyreference) - [liveWindowEnd](/docs/metadata-specifications#livewindowend) - [visibilityDate](/docs/metadata-specifications#visibilitydate) - [displayStartDate](/docs/metadata-specifications#displaystartdate) - [availabilityStatus](/docs/metadata-specifications#availabilitystatus) - [airingType](/docs/metadata-specifications#airingtype) - [subjectToCoppa](/docs/metadata-specifications#subjecttocoppa) - [ivod](/docs/metadata-specifications#ivod) - [listingStartTime](/docs/metadata-specifications#listingstarttime) - [stationReference](/docs/metadata-specifications#stationreference) - [eventTournamentReference](/docs/metadata-specifications#eventtournamentreference) - [sportsConferenceReference](/docs/metadata-specifications#sportsconferencereference) - [timeSlice](/docs/metadata-specifications#timeslice) - [timeMarker](/docs/metadata-specifications#timemarker) - [videoSource](/docs/metadata-specifications#videosource) - [sourcePart](/docs/metadata-specifications#sourcepart) - [breakpoint](/docs/metadata-specifications#breakpoint) - [media:status](/docs/metadata-specifications#mediastatus) - [media:group](/docs/metadata-specifications#mediagroup) - [media:content](/docs/metadata-specifications#mediacontent) - [media:rating](/docs/metadata-specifications#mediarating) - [media:thumbnail](/docs/metadata-specifications#mediathumbnail) - [media:keywords](/docs/metadata-specifications#mediakeywords) - [media:copyright](/docs/metadata-specifications#mediacopyright) ****Content Fields**** - [metadataFile](/docs/metadata-specifications#metadatafile) - [audioTrack](/docs/metadata-specifications#audiotrack) - [subtitle](/docs/metadata-specifications#subtitle) - [videoCodec](/docs/metadata-specifications#videocodec) - [videoQualityVariant](/docs/metadata-specifications#videoqualityvariant) - [audioCodec](/docs/metadata-specifications#audiocodec) - [transport](/docs/metadata-specifications#transport) - [protectionMethod](/docs/metadata-specifications#protectionmethod) - [protectionKey](/docs/metadata-specifications#protectionkey) - [container](/docs/metadata-specifications#container) - [protectionScheme](/docs/metadata-specifications#protectionscheme) - [protectionSystem](/docs/metadata-specifications#protectionsystem) - [appStartMode](/docs/metadata-specifications#appstartmode) - [appMetadata](/docs/metadata-specifications#appmetadata) - [optimizedFor](/docs/metadata-specifications#optimizedfor) - [adCompatibility](/docs/metadata-specifications#adcompatibility) - [adInstructions](/docs/metadata-specifications#adinstructions) - [targetPlatforms](/docs/metadata-specifications#targetplatforms) - [publicationStatus](/docs/metadata-specifications#publicationstatus) - [packageType](/docs/metadata-specifications#packagetype) - [watermarkEndDate](/docs/metadata-specifications#watermarkenddate) - [adminTag](/docs/metadata-specifications#admintag) - [categoryPath](/docs/metadata-specifications#categorypath) - [originalHeight](/docs/metadata-specifications#originalheight) - [originalWidth](/docs/metadata-specifications#originalwidth) - [watermark](/docs/metadata-specifications#watermark) - [trackAssignment](/docs/metadata-specifications#trackassignment) ****Distribution Rights Fields**** - [valid](/docs/metadata-specifications#valid) - [contentCatalog](/docs/metadata-specifications#contentcatalog) - [contentCatalogs](/docs/metadata-specifications#contentcatalogs) - [contentClass](/docs/metadata-specifications#contentclass) - [contentTier](/docs/metadata-specifications#contenttier) - [playRegions](/docs/metadata-specifications#playregions) - [playRegion](/docs/metadata-specifications#playregion) - [downloadable](/docs/metadata-specifications#downloadable) - [streamable](/docs/metadata-specifications#streamable) - [restriction](/docs/metadata-specifications#restriction) ****Content Rights Fields (legacy)**** - [restriction](/docs/metadata-specifications#restriction-legacy) - [segment](/docs/metadata-specifications#segment-legacy) - [proposition](/docs/metadata-specifications#proposition-legacy) - [windowType](/docs/metadata-specifications#windowtype-legacy) - [windowMode](/docs/metadata-specifications#windowmode-legacy) - [valid](/docs/metadata-specifications#valid-legacy) - [downloadable](/docs/metadata-specifications#downloadable-legacy) - [streamable](/docs/metadata-specifications#streamable-legacy) ## SportingEvent ****General Fields**** - [title](/docs/metadata-specifications#title) - [description](/docs/metadata-specifications#description) - [seriesTitle](/docs/metadata-specifications#seriestitle) - [durableAppId](/docs/metadata-specifications#durableappid) - [pubDate](/docs/metadata-specifications#pubdate) - [contentProviderName](/docs/metadata-specifications#contentprovidername) - [distributionRights](/docs/metadata-specifications#distributionrights) - [videoAssetId](/docs/metadata-specifications#videoassetid) - [programVariantId](/docs/metadata-specifications#programvariantid) - [brand](/docs/metadata-specifications#brand) - [distributor](/docs/metadata-specifications#distributor) - [entityType](/docs/metadata-specifications#entitytype) - [entityReference](/docs/metadata-specifications#entityreference) - [tagReference](/docs/metadata-specifications#tagreference) - [languageDetails](/docs/metadata-specifications#languagedetails) - [displayStartDate](/docs/metadata-specifications#displaystartdate) - [liveWindowEnd](/docs/metadata-specifications#livewindowend) - [availabilityStatus](/docs/metadata-specifications#availabilitystatus) - [visibilityDate](/docs/metadata-specifications#visibilitydate) - [airingType](/docs/metadata-specifications#airingtype) - [externalAssetId](/docs/metadata-specifications#externalassetid) - [externalEntityId](/docs/metadata-specifications#externalentityid) - [externalSeriesId](/docs/metadata-specifications#externalseriesid) - [durableAppId](/docs/metadata-specifications#durableappid) - [media:status](/docs/metadata-specifications#mediastatus) - [media:rating](/docs/metadata-specifications#mediarating) - [media:group](/docs/metadata-specifications#mediagroup) - [media:thumbnail](/docs/metadata-specifications#mediathumbnail) ****Distribution Rights Fields**** - [valid](/docs/metadata-specifications#valid) - [contentClass](/docs/metadata-specifications#contentclass) - [contentTier](/docs/metadata-specifications#contenttier) - [playRegions](/docs/metadata-specifications#playregions) - [playRegion](/docs/metadata-specifications#playregion) --- ## Examples ### Movie Example ```xml    Harry Potter and the Goblet of Fire    2018        GMO_1111    GTMV0000645117    long    SkyShowtime    Warner Brothers    appId    Movie    entity123    Harry Potter    Harry Potter and the Goblet of Fire medium synopsis.    Hermione and Ron try to help Harry win the tri-wizard tournament.    3800        5    N/A        Genre:Movies    Subgenre:Sci-Fi & Fantasy    GN164S651XQJ19N    action        GTMV0000645117    SH030065870000                NBC_ID_MM        NBC_ID_DUMBLE                                                                                                                                                                                    H.264            AAC            HLS            cmaf-hls-24fps-peacock-v1            Streaming            ISOBMFF            CBCS            CKS            PLAYREADY            WIDEVINE            "TEST-US-SLE-1-CENC:peacock_801363"                            NBC            start=2021-04-20T00:00:00Z;end=2120-01-01T05:00:00Z;scheme=W3C-DTF        SVOD        Basic                    PL                         PL         inclusive                 RECS         exclusive                 ``` ### SeriesMaster Example ```xml    Angry Birds Toons [TV Series]    Brings to life the characters and adventures from the Angry Birds game.    736369    736369    SH017110630000    SeriesMaster         ``` ### TvSeason Example ```xml   The Office Season 1   Season 1 of the acclaimed Comedy about people who work in an office.   GTMV0000111111-1   1   TvSeason       736369   GTMV0000111111-1 ``` ### Episode Example ```xml    Basketball    The Office    Basketball    Basketball medium Description    Facing a basketball game against the warehouse employees, Michael raises the stakes and bets on his handpicked team.    1312416000000    GMO_14713006559    GTM1234    long    nbcentertainment    SkyShowtime    appId    Episode    1    5    3800    entity123    series123        5        Genre:Movies    Subgenre:Sci-Fi & Fantasy    GN164S651XQJ19N    action        EP034829100019        SM5678        GTMV0000645117                                                                                                                                                                            H.264            AAC            HLS            cmaf-hls-24fps-peacock-v1            Streaming            ISOBMFF            CBCS            CKS            PLAYREADY            WIDEVINE            "TEST-US-SLE-1-CENC:peacock_801363"                                      SKYSHOWTIME            base_d2c                            PL            SKYSHOWTIME            SKYSHOWTIME                ARCHIVE        SVOD        start=2021-01-01T00:00Z;end=2021-12-31T00:00Z;scheme=W3C-DTF                     PL             inclusive                             RECS             exclusive                true        true                        inclusive        subjectToCoppa                 ``` ### SportingEvent Example ```xml            sample feed        sample feed                    Broncos v Panthers            National Rugby League            ....            199978            199978            SportingEvent            SAMP            G                            start=2023-05-18T09:50Z;end=2023-05-25T12:45Z;scheme=W3C-DTF                LIVE                SVOD                basic                                    ZA                                                                                                                                                                2023-05-18T08:30Z            2023-05-18T12:45Z            EphemeralStream            UPCOMING            SAMP            LIVE            Brisbane            Penrith            NRL            Rugby league              IH000401298            IH000401298            SI000000001            com.sky.SAMP                   ```