Episodes are created within a season and can contain any type of video asset (full episode, preview, or clip). If an episode does not belong to a season, it will be treated as a Special

How to create an episode

FieldNotesRequired for create?
Title60 character limit, including spaces.Y
SlugAuto-generated unique identifier that cannot be changed after initial save.Y (automatically generated from Title, and is editable only prior to initial save)
PBS Content IDAuto-generated unique identifier.Y (automatically generated; not editable)

Unique Gracenote identifier that is matched to an associated ID in the TV Schedules Service (TVSS) API.

(1) TMS ID fields:

TMS ID FieldDescription
Matched TMS ID (Default selection)

Matched TMS ID automatically attempts to match a show or episode with its corresponding object in TVSS. If a match is successfully made, the Gracenote-generated TMS ID is populated and TVSS details (title, description) are provided for context.

If no match is found in TVSS, it’s due to one of the following reasons:

  • PBS has no corresponding object in TVSS.
  • The object exists in TVSS, but the metadata for the object in TVSS and in Media Manager is too different to produce a reliable match.

If no match is found in TVSS, this status is provided in the TMS ID and TVSS Details fields.

Custom TMS ID

If selected, user must enter a known, valid TMS ID that is generated by Gracenote. Manually-generated TMS IDs are not permitted.

A common use case for this setting is when an automatic match cannot be made with the Matched TMS ID setting, it allows a user to enter a valid TMS ID .

This selection overrides a Matched TMS ID.


No TMS ID prevents a TMS ID from being assigned (automatically or manually) to the object.

This selection overrides a Matched TMS ID.

(2) Existing TMS ID: The TMS ID that was manually entered and already existed in Media Manager. This only displays if there was an existing TMS ID in Media Manager.

(3) TVSS Details: Displays the show details that are pulled from TVSS when a successful match has been made between the TMS ID and TVSS.

Episode NOLASix-digit broadcast code that represents a show, season number, and episode number.N
Episode NumberMust be unique to the season (in other words, you cannot have more than one episode 3, for instance).Y (auto-incremented, but editable)
SegmentIdentifies segments of a single episode. Used primarily by PBS KIDS.N
Short Description90 characters or less, including spaces. Used primarily when space is limited, such as on apps and small screens.Y
Long Description400 characters or less, including spaces.Y
Premiere DateOriginal on-air or online broadcast date.Y (pre-filled with current date; is editable)
Encore DateOn-air rebroadcast date.Y (pre-filled with current date; is editable)
CreatedThe date and time the special is created.N/A
UpdatedThe date and time the special was last updated.N/A

If you are working within a season that has already been created, follow the steps below to create an episode within the season. If you have not yet created a season, learn how to create a season.

  • Be sure you are in the correct season by clicking the show, then the Seasons tab, and the link to the season to which you want to add the episode. 
  • Once you are in the season you want, click Create Episode (Figure 1).

Figure 1

  • Click the season to which you want to add the episode (Figure 2).

Need to create a season? Learn how to create a season

Figure 2

  • Click Create Episode (Figure 3).

Figure 3

  • In the Title textbox, type a title for your episode containing no more than 60 characters, including spaces. The slug auto-populates as you type the title (Figure 4.1).
  • In the Episode textbox, type the number of your episode (Figure 2.2). Episodes use ordinal numbers to identify each episode's position in the season. This means that the first episode you add will be labeled "1," the second episode will be labeled "2," and so on (Figure 4.2). If episodes already exist in this season, this field auto-populates with the next logical episode number.
  • The Segment field is available as an identifier for multi-part episodes (Figure 4.3). This is rarely used and you do not need to worry about this field.
  • In the Short Description textbox, type a short description containing no more than 90 characters, including spaces and in the Long Description textbox, type a long description containing no more than 400 characters, including spaces (Figure 4.4). (info) These fields accept HTML (example code: <a href="http://www.pbs.org">PBS</a>).
  • When finished, click Save (Figure 4.5).

If you receive an error message (500) when saving your file, check the Title field to be sure your character count has not surpassed 60 characters. If you have copied and pasted your title from another source such as Microsoft Word, some special characters, such as apostrophes, quotes, and commas may count as multiple character spaces and put your title over 60 characters. Try manually typing your title into the Title textbox.

Figure 4

  • The episode has saved and all fields from the previous screen are pre-filled. You can modify some of the fields, such as Short and Long Descriptions.
  • Fill out the Episode NOLA in Core Data tab (Figure 5.1). This is not required.
  • The Premiere Date defaults to the date the episode was created. To modify the date, manually type the date into the textbox or click the calendar icon on the right side (Figure 5.2).
  • The Encore Date is the on-air rebroadcast date (Figure 5.3). It defaults to the same date as the Premiere Date but can be modified in the same way you would modify the Premiere Date.
  • Click Save (Figure 5.4).

Figure 5

  • Click the Assets tab to add a video asset for your episode (Figure 6).

Figure 6

How to add assets

Learn how to create a video asset

How to add additional data

  • Click the Additional Data tab to provide additional information about your episode such as:
    • Links to buy the DVD or purchase the episode on iTunes, donate to a station, or link to the producer site responsible for the episode.
    • The collection to which the episode belongs.
    • The language in which the video is presented. 

Figure 1

  • In the Links section, click the Type dropdown menu and select the type of link you want to add to your episode (Figure 2.1).
  • In the URL textbox, type the full URL to the page associated with the selection you made in the Type dropdown menu (Figure 2.2).
  • Click Add More to add additional rows (Figure 2.3).

Figure 2

  • To delete any of your selections, simply click the trashcan icon next to the selection you wish to delete (Figure 3). The selection is removed and cannot be recovered. If you deleted it in error, you must be add it again.

Figure 3


Learn more about Collections

  • To add your episode to an existing collection, in the Collections section click the name of the collection to which it should be added (Figure 4.1).
  • The number of available collections is listed at the top of the selectbox on the left (Figure 4.2).
  • To search existing collections, type keywords in the Filter box (Figure 4.3). 

Figure 4


  • Click the Language dropdown menu and click the language that reflects the primary language in which your episode is presented (Figure 5.1). The default language is English but can be changed to Spanish.
  • When finished with all of your Additional Data selections, click Save (Figure 5.2).

Figure 5

  • An alert appears notifying you that your changes have been saved (Figure 6).

Figure 6

How to delete an episode

  • Click the title of the episode you want to delete (Figure 1).

Figure 1

  • Click the Core Data tab (Figure 2).

Figure 2

  • In the lower left corner of the screen, click the red Delete Episode button (Figure 3).

Figure 3

  • Click Yes, I'm sure (Figure 4.1).
  • If you change your mind and don't want to delete the special, click No, take me back (Figure 4.2).

Figure 4

  • A confirmation message appears at the top of the screen stating that the episode and its associated assets have been deleted (Figure 5.1).
  • The episode has been removed from the list of episodes (Figure 5.2). 

Episode numbers are not automatically reordered or relabeled. If you do not add a new episode to fill the space of the deleted episode, you may want to renumber or rename the episodes for organizational purposes.

Figure 5

How to edit or move your episode

If you have added your episode to the wrong season or you need to change your episode to a Special, follow these instructions.

TMS ID Matching Logic for Episodes/Specials

The below diagram illustrates the logic used to attempt matching episodes and specials in TVSS and Media Manager. (Click diagram to enlarge.)