---
title: "Assets"
canonical: "https://docs.pbs.org/space/MM/5343793/Assets"
format: markdown
---
> Macro (toc)
## Overview
An asset is a video file that can be contained within a [Franchise](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5343789), [Show](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5343796), [Season](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5343800), [Special](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5343806), and [Episode](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5343798). Assets can be full length episodes, clips, or previews. Because video clips and previews (*not full length episodes*) can be considered "Extras" in their own section on PBS.org, Media Manager provides the ability to create Assets and [Extras](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5344064) in two separate places in the console.
Episodes and Specials can contain only one full length episode but may include unlimited clips and previews. Once you have added a full length episode, you cannot add another to the same object.
Media Manager optimizes the raw video file that you add to your asset and automatically generates several formats to adapt to a user's internet speed. So if a user with a slow internet connection clicks on your video, they are automatically served the file size that accommodates their internet connection speed.
The following table illustrates the relationship between objects and asset types. It shows which objects accept specific asset types.
| | **Franchise** | **Show** | **Season** | **Special** | **Episode** |
| --- | --- | --- | --- | --- | --- |
| **Full Length** | :cross_mark: | :cross_mark: | :cross_mark: | :check_mark: | :check_mark: |
| **Preview** | :check_mark: | :check_mark: | :check_mark: | :check_mark: | :check_mark: |
| **Clip** | :check_mark: | :check_mark: | :check_mark: | :check_mark: | :check_mark: |
## Video specifications
**[Click here for image and text specs](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5343808)**
> Macro (excerpt-include)
## How to create a video asset
| **Field** | **Notes** | **Required for Create?** | **Required for Publish?** |
| --- | --- | --- | --- |
| Core Data |
| Object Type | Types include: Full Length, Preview, Clip | Y | Y |
| Title | Title of the asset. 120 character limit, including spaces. When users search for videos, the content of this field is searched. | Y (Full length assets inherit title from parent episode/special. Clips and previews require title.) | Y |
| Slug | Auto-generated unique identifier | Y (automatically generated from Title, and is editable only prior to initial save) | Y |
| PBS Content ID | Auto-generated unique identifier. This is also used to surface a preview video clip on a show page when placed in the [Featured Preview Content ID](https://docs.pbs.org/space/MM/5343796/Shows#Featured-Preview-Content-ID) field in the [Miscellaneous section](https://docs.pbs.org/space/MM/5343796/Shows#Miscellaneous) of the Additional Data tab of a show. | Y (automatically generated; not editable) | Y |
| Short Description | 100 characters or less, including spaces. Used primarily when space is limited, such as on apps and small screens. When users search for videos, the content of this field is searched. | Y (Full length assets inherit Short Description from parent episode/special. Clips and previews require Short Description.) | Y |
| Long Description | 400 characters or less, including spaces. When users search for videos, the content of this field is searched. | Y (Full length assets inherit Long Description from parent episode/special. Clips and previews require Long Description) | Y |
| Premiere Date | Original on-air or online broadcast date | Y (pre-filled with current date; is editable) | Y |
| Encore Date | On-air rebroadcast date | Y (pre-filled with current date; is editable) | Y |
| Tags | Used in the API and for advanced discoverability in a site search | N | |
| Content Rating | | N | |
| Created | The date and time the asset is created | N/A | |
| Updated | The date and time the asset was last updated | N/A | |
| Additional Data |
| Exclude From DFP | On/Off. Determines whether or not sponsorship ads will be displayed for associated videos. | Y (Inherits from parent show. Can only be changed to On, if parent show is set to Off.) | Y |
| Funder Message | Optional field. | N | |
| Allow Topics
or
Topics | On/Off. Legacy field, no longer used by PBS front end. Asset value inherits from parent show. | Y (Inherits from parent show) | |
| Legacy TP Media ID | This is a legacy ID that should only be used for backwards compatibility, and not for new implementations. Transitioning to the PBS Content ID is strongly recommended.
We do not have plans to eliminate the TP Media ID at this time | Y (Auto-generated; not editable) | Y |
| Related Content |
| Episode Links | Represented on pbs.org video pages (only) in the Episode Links section | N | |
| Learn More Promos | Represented on [pbs.org](http://pbs.org) video pages (only) in the Learn More section | N | |
| Availability |
| Passport | Assign date/time availability windows for:
Public Users
All Passport Members
Your Station's Passport Members (applies to local shows only) | Y | Y |
| Geo Availability | Identifies the countries in which the video is available. Inherited from the parent show, and can be overridden on the asset level. | Y | Y |
| Platform Management | Identifies the platforms on which the video is available. Inherited from the parent show, and can only be made more restrictive on the asset level. | Y | Y |
| Video |
| Video | Video file
Can be replaced at any time without disrupting viewer experience | N | Y |
| Closed Captioning | Caption file
Caption requirement inherits from the parent show
Captions can be included for assets that do not have a caption requirement
Can be replaced at any time without disrupting viewer experience | N | Depends, if captions are required for the parent show. |
| Auto Publish | On/Off. When set to "On", the asset will publish after all required-for-publish fields are complete.
Default=Off | N | |
| Allow Viral Player Embed | On/Off. The setting inherits from the parent show.
The viral player provides up to 20 minutes of a video. When set to "On", this displays an embed icon with the video player, and allows site users to embed the viral player on their own site. | Y | |
| Partner Player | The partner player provides the full video, and the embed code for it is available to users with access to this published video asset. | N/A
Partner Player code is provided for published video assets. | |
| Images |
| Image | Various profile types available
Can be replaced at any time without disrupting viewer experience | N | Y |
| Chapters |
| Chapters | Assign chapter marks | N | |
| Preview Video |
| Status & Preview | View asset status, and preview successfully ingested video files | N/A | |
### How to add notes
> Macro (excerpt)
>
> The Notes feature provides a place for editors to store internal notes and collaborate with colleagues. Notes is an optional feature intended as a convenience for console users and is not included in the API or displayed on frontend platforms. The text limit is 2,000 characters, including spaces, and can contain text only (hyperlinks can be added but they will not be clickable).
>
> To use the Notes feature, simply click **Notes** at the top of the page and begin typing. The Notes bar displays in yellow when content has been added. If no notes are present, the bar displays in grey. When finished, click** Save Notes** to save your changes or **Delete Notes** to clear the entire field. The Notes feature contains its own save buttons that are separate of the object’s save buttons. So if you save the page but you don’t save the Notes section, your notes are not saved.
>
> Notes are read-only for the [viewer role](https://docs.pbs.org/space/MM/5343868/Roles+and+Permissions).
>
> [View a quick demo](https://s3.us-east-1.amazonaws.com/pbs.panda-prod.cdn/media/help/notes-demo.mp4) (video opens in new window; close window to return to docs.pbs.org)
### Create your asset
- From an Episode or Special, click the** Assets tab** (Figure 1.1).
- Click **Create Asset** located on the right side of the screen (Figure 1.2).
> Macro (anchor)
[Learn how to access Extras](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5344064)
Figure 1
- Click the **Object type dropdown menu** and select **Full Episode**, **Preview**, or **Clip **(Figure 2).
> ℹ️ **If Full Episode is not available, the object likely already contains a full episode.**
Figure 2
- The selected object type displays (Figure 3.1).
- In the Title textbox, type the **title of your video asset **(Figure 3.2). **The title should ****contain no more than 120 characters, including spaces.**
- The slug is automatically created based on the title (Figure 3.3).
- Click **Save** (Figure 3.4).
> ❌ If you receive an error message (500) when saving your file, check the Title field to be sure your character count has not surpassed 120 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 120 characters. Try manually typing your title into the Title textbox.
Figure 3
- A message confirming that your asset has saved displays in a green bar at the top of the page (Figure 4.1).
- A persistent status bar displays at the top of the page and provides a quick view of the asset's status, including its published status, availability, and completion of required fields (Figure 4.2). Now you can begin filling out the rest of the metadata and add your video and caption files.
Figure 4
### Core Data
- If the asset contains a full length episode, the Title, Object type, Short and Long Descriptions are all carried over from the previous screen (Figure 1.1). Previews and Clips do not inherit the descriptions of the episode and must be added at the asset level.
- The Object type can be modified at the asset level, however, the Short and Long Descriptions are pulled from the Episode page and must be modified at the episode level (Figure 1.2). Short Description has a limit of 100 characters, including spaces. Long Description has a limit of 400 characters, including spaces. **You cannot change the short and long descriptions of a full episode, only clips and previews. You must go back to the ****[episode page](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5343798)**** and change the descriptions there.**
- Click the** Premiere** and **Encore Date textboxes** to modify the dates (Figure 1.3).
- Premiere date is the original online or on-air date of the video.
- Encore date is the date the video is rebroadcast on-air.
- In the Tags textbox, type **keywords** that will help viewers find your asset (Figure 1.4). Tap the **Enter key** on your keyboard to enter each word or phrase. Click the **x** in the upper right side of each tag to remove a tag.
- Click the **Content rating dropdown menu** and select a** rating for this asset** (Figure 1.5). [View ratings](/wiki/download/attachments/5343793/ratings.pdf?version=1&modificationDate=1500578962445&cacheVersion=1&api=v2) **NR = No rating*
- Click the** Content rating descriptor dropdown menu** and click the **descriptor that is appropriate for your asset** (Figure 1.6). Each chosen descriptor appears in the textbox and can be removed by clicking the **x** on the left side of each entry. **This field only displays after you have selected a Content rating.**
- The date, time, and author of the asset creation and last update displays (Figure 1.7).
- When finished, click **Save** (Figure 1.8).
Figure 1
### Additional Data
- Click the **Additional Data tab** (Figure 1).
Figure 1
- Click the **Exclude from DFP toggle** to allow or prevent DFP pre-roll from displaying on your video asset (Figure 2.1). When the toggle displays ON, content is excluded. When the toggle displays OFF, DFP content is shown during your video.
Learn more about pre-roll
#### > Macro (anchor)
Pre-roll
- The PBS video products can carry a standard pre-roll message, up to 30 seconds in length, for streaming video that is 3 minutes in length or longer.
- All in-stream national message delivery on national content is managed by PBS. Sponsorship messages are served using Google Ad Manager.
- All in-stream local message delivery on local content is managed by stations. Sponsorship messages are served using Google Ad Manager.
- If you would like access to Google Ad Manager, fill out this [form](https://docs.google.com/forms/d/e/1FAIpQLSeTAu0q9ColRC-Jsc9yltNKzD-uGHT16_ds2OmVd16oUdloTg/viewform).
- In the Funder Message textbox, type any **acknowledgments associated with your show** (Figure 2.2). Maximum length: 500 characters, including spaces.
> ⚠️ **If funder text is set at the ****[Show level](https://docs.pbs.org/space/MM/5343796/Shows)**** and you want the same text to display on your assets, leave this blank.**
See where funder text displays
- Click the **Allow Viral Player Embed toggle** so that it displays ON if you want third party websites to be able to embed this asset on their website (Figure 2.3). [Learn more about the Viral Player](https://docs.pbs.org/space/MM/5344942/The+Viral+Player)
- Click the **Language dropdown menu** and click the **primary language** in which your video is presented (Figure 2.4).
- In the Enhance HTML Title Tag textbox, type a **few descriptive words** about the asset subject matter (Figure 2.5). This is included in the HTML page title, which enhances SEO and social sharing.*** ***
- The ability to add topics is determined in the [Additional Data tab](https://docs.pbs.org/space/MM/5343796/Shows#Additional-Data) of the show to which the asset belongs. Please [file a support ticket](http://digitalsupport.pbs.org/support/tickets/new) to enable, disable, and assign Topics at the show level. If Topics are enabled, click the **Topics dropdown menu** and select a **topic** from the list provided (Figure 2.6). [View roles and permissions](https://docs.pbs.org/space/MM/5343868/Roles+and+Permissions)
- The Legacy TP Media ID is a legacy ID that is auto-generated and should be ignored (Figure 2.7). When referencing a video asset by its ID, the PBS Content ID (CID) should be used.
- Click **Save** (Figure 2.8).
Figure 2
### Related Content
#### **Episode Links and Learn More Promos**
Use the related content section to add up to eight (8) [remote assets](https://docs.pbs.org/space/MM/5343943/Remote++Assets) to your video page. Learn More Promos contain titles, images, and descriptions, while Episode Links are plain text and links. Both forms of related content should be relevant to the main content of your video. You can add up to four (4) Episode Links and four (4) Learn More Promos.
***Related Content is optional.***
[Learn how to create a Remote Asset](https://docs.pbs.org/space/MM/5343943/Remote++Assets#How-to-create-a-Remote-Asset)
- Episode Links display in the* Keep Exploring* section and can contain links to other websites (Figure 1.1) and a newsletter (Figure 1.2).
- Rich promos, consisting of a title, description, image, and URL display with a *Related to This Episode* heading (Figure 1.3). A maximum of four Learn More promos are allowed.
Figure 1
See where Related Content is located on PBS.org
- Click the **Related Content tab** (Figure 1.1).
- To add an Episode Link that already exists in Media Manager, click the green **Add Existing** button in the *Episode Links* section, or click **Create New** to create an entirely new remote asset (Figure 1.2).
- To add a Learn More Promo that already exists in Media Manager, click the green **Add Existing** button in the *Learn More Promos *section, or **Create New** to create an entirely new remote asset (Figure 1.3).
> ⚠️ **You can create a remote asset from this page by clicking Create New but we recommend creating your remote assets in the ****[Remote Assets section](https://docs.pbs.org/space/MM/5343943/Remote++Assets#How-to-create-a-Remote-Asset)**** of the Media Manager console.**
Figure 1
> ⚠️ The following sections demonstrate how to add existing links. If you need to create a new episode link or Learn More Promo, [learn how](https://docs.pbs.org/space/MM/5343943/Remote++Assets#How-to-create-a-Remote-Asset).
#### Add Episode Links
Episode links are plain links with a preceding label that displays* Keep exploring*. The* Keep Exploring* label cannot be modified.
- To search for a remote asset by keyword, type **search criteria** in the search textbox on the right side of the page and tap **Enter on your keyboard** or click the **magnifying glass icon** (Figure 1.1).
- To browse remote assets, use the filters along the top of the page (Figure 1.2):
- Click the ***All Franchises***** dropdown menu** to browse within a particular franchise
- Click the ***All Shows***** dropdown menu** and click the **show you want to browse**
- Click the ***Asset type***** dropdown** menu and click the **type of asset you want to add**
- If enough assets are returned in the results, pagination will appear in the bottom right side of the page (Figure 1.3).
- In the *Select *column on the far left side of the page, next to the episode link you want to add, click **Add** (Figure 1.4).
Figure 1
- After you've added up to four (4) episode links, the links display in a list at the bottom of the page (Figure 2.1).
- Click **Save** to add them to your video asset (Figure 2.2).
Figure 2
- Once you have added a total of four episode links to your assets, the green *Add Existing* and* Create New* buttons no longer display. The only way to modify your list is to delete one of your current selections. When you do that, the buttons display and you can select a new episode link. To delete a link, click the** trashcan icon** on the right side of the link you wish to delete (Figure 3).
Figure 3
#### Add Learn More Promos
Learn More Promos display on PBS.org under a header that reads *Related to this Episode*. This heading cannot be modified.
The steps for adding Learn More Promos are the same as adding Episode Links so please follow the steps listed above.
#### > Macro (anchor)
Alternate Accessibility Versions
In the Media Manager console, you can relate *multiple, separate instances* of the same video content, each with **different enhanced accessibility features** and **different source video files**. This helps users on pbs.org easily navigate between the related versions within the video player. (A > Macro (inline-media-image)
icon displays in the player control area, when one or more enhanced accessibility versions are available for a video.)
**What is Enhanced Accessibility?**
An accessibility option which is unique to a particular video, and/or may result in a unique video duration. The Enhanced Accessibility options in Media Manager include:
- **American Sign Language (ASL): **A visual language, where information is conveyed using shape, placement, and movement of the hands, as well as facial expressions and body movements.
- **Extended Audio Description (EAD): **With standard Audio Description (AD), descriptions fit within the existing, natural pauses in the video. With Extended Audio Description (EAD), longer pauses are added within the video, to provide opportunities for lengthier descriptions and more context. EAD videos are typically longer in duration.
- **Open Captions (OC):** Captions which are burned into the video file and are always displayed during playback. Open Captions cannot be customized or turned off by the user.
- **NOTE: **To comply with FCC caption requirements, a video with Open Captions can be provided as an *alternate* version, as long as there is another version available which has standard, customizable, and properly position captions.
**Why do videos with Enhanced Accessibility need to be separate versions (i.e. separate Media Manager video assets)?**
Each version typically has a unique source video file, which can vary based on the content and duration. A Media Manager video asset can only accept one video file.
*Standard accessibility options* can be managed within a single Media Manager asset because there is a single source video file, with a single duration. Standard options include: Multiple caption files for different languages, and multiple audio tracks for AD and different languages .
**Example use case for relating enhanced accessibility videos**
Say you have four (4) separate Media Manager video assets which all represent the same content, but the video duration and enhanced accessibility feature for each one is different:
1. One instance has no enhanced accessibility options and the duration is 45 min. (It *would* have at least some of the *standard* accessibility options/requirements, such as one or more caption files, and one or more audio tracks included in the video file.)
2. One instance has EAD (Extended Audio Description) and the duration is 60 min. (It's longer because extra pauses are added to provide more opportunities for audio description.)
3. One instance has ASL (American Sign Language) and the duration is 45 min. (Its duration is the same as #1 but the video is presented with sign language, so it's a different video file.)
4. One instance has OC (Open Captions) and its duration the 45 min. (The duration is the same as #1 but the video has burned-in captions which cannot be removed or customized. Open Captions may be preferred for some users, but they do not satisfy the FCC's caption requirements for standard, customizable, and properly positioned captions. **The Open Caption video instance could only be provided as an *****alternate***** version.**
**How to relate videos with Enhanced Accessibility features**
1. Go to the Related Content tab for **one of the videos.** This is the (only) video where you will manage the relationships. For the example above, it's recommended to start in the non-enhanced version (#1), but it's not a requirement.
2. Scroll down to the “Alternate Accessibility Versions” section.
3. Add one related video at a time, entering its asset CID, and selecting the accessibility type.
- The accessibility type for the initial video must also be selected.
**How to tell if a video on pbs.org has enhanced accessibility versions**
On pbs.org, when one or more enhanced accessibility versions are available for a video, a > Macro (inline-media-image)
icon displays in the player control area.
### Availability
Availability determines the access viewers have to your video and the platforms on which your video is available.
#### Passport availability
Use the Passport Availability section to assign what type of users can access your content and the geo location of those users who should have access. Can all users access your content from anywhere in the world or should only those with a Passport membership have access? [Learn more about Passport](https://docs.pbs.org/space/PLUS/5505086/Passport) (This link takes you to the MVault documentation).
User types and permissions are defined as follows:
| **User type** | **Definition** |
| --- | --- |
| Public | Users who are not Passport members (general public), or are not logged in. |
| All Passport Members | All Passport members across all stations. |
| Your Station's Passport Members | Passport members belonging to one or more stations. Station assignment is determined in [Audience section of the Core Data tab](https://docs.pbs.org/space/MM/5343796/Shows#Core-Data) in a show. [Please contact PBS to modify the Audience field](http://digitalsupport.pbs.org/support/tickets/new)
You can vary programming windows depending on the User Type.
***This user type only displays for station programs; national programs have no station component.*** |
| **Geo Availability** | **Definition** |
| Countries | The countries in which the asset is available for viewing.
***All assets inherit geo restrictions that are assigned at the show level. Individual assets can only be made more restrictive, not less restrictive. For instance, if restrictions at the show level are set to US and Canada, you cannot set your asset's restrictions to include US, Canada, and Mexico.*** |
| **General Availability ** | **Definition** |
| Not Available | Never allowed to view the video. |
| Always Available | Always allowed to view the video. |
| Custom Time Frame | Allowed to view the video for a specific time frame. |
> ⚠️ **User types are listed in descending order from basic to advanced permissions. You cannot grant a "lesser" role more permissions than an advanced role. Each user type and permissions can only increase over the role above it. For instance, you cannot make an asset available to everyone (Public) but restrict it from Passport members.**
### How to assign availability
- Click the** Availability tab** (Figure 1).
- Availability settings for Public users are listed first. Click the **calendar icon** on the right side to set the availability status or assign a custom time frame (Figure 1.1).
- Click the **Geo Availability** **dropdown menu** to select the countries in which the asset should be viewable (Figure 1.2).
- If you wish to customize the countries, click the **checkbox** next to ***Edit selected countries**** *(Figure 1.3). This brings up a country selector that allows you to select individual countries.
- The selectbox on the left contains all available countries ([see each country's corresponding code](https://countrycode.org/)). To search for a specific country, type the **country code** in the textbox provided (Figure 1.4) or click **each individual** **country **that should have viewing permissions (Figure 1.5). Each time you click a country code, the country automatically moves to the selectbox on the right, indicating it has been selected.
- Select all countries by clicking** Add All** (Figure 1.6).
- Selected countries display in the selectbox on the right (Figure 1.7). Click each** country code** to remove it from the selected list.
- To remove all countries, click **Remove All** (Figure 1.8).
Figure 1
- To assign *Passport *users the same viewing permissions as *Public *users, click the **checkbox** next to*** Apply "Public Users" availability setting for Passport Members*** (Figure 2). When this is checked, Passport member options are grayed out and Passport members have the same availability permissions as the public. If these settings should be different from Public users, follow the steps in Figure 1.
Figure 2
- The new parameters are recorded and display in the dropdown menu. At any time you can return the asset to its original settings by clicking the **Set to the Show's default setting: (Always Available) **link located beneath each dropdown menu (Figure 3).
Figure 3
> ⚠️ ### Notes on Availability
> ⚠️
> ⚠️ When viewing your list of Assets and Extras, the *Availability *column displays green checkmarks and red x's. These serve as a quick way of determining the availability assigned to a specific asset or extra. The order of the icons, from left to right, is as follows:
> ⚠️
> ⚠️ - Public users
> ⚠️ - All Passport members
> ⚠️ - Your Station's Passport members
> ⚠️
> ⚠️ In the following example, the Dublin Castle asset is ***not available*** to public users and all Passport members, however, your Station's Passport members can see the asset.
> ⚠️
> ⚠️ 
### Platform Management
Use the Platform Management section to choose the platforms on which you want your asset to be available. If no platforms are selected, your asset does not display anywhere and can only be accessed by the direct URL to the object.
- To search for a specific platform, type the **platform name** in the textbox provided (Figure 1.1) or click **each individual** **platform **(Figure 1.2).
- Click **Add All** to select all platforms (Figure 1.3).
- Each time you click a platform, it automatically moves to the selectbox on the right, indicating it has been selected (Figure 1.4).
- To remove all platforms, click **Remove All** (Figure 1.5). To remove a single platform, click the **platform name** and it will move back to the box on the left side.
- When finished, click **Save** (Figure 1.6).
View a quick demo
Figure 1
### Video, Caption, and Transcript Files
Use the video section to add your video and closed captioning files. Each asset may contain one video file but multiple caption files, depending on the language of your video.
- To begin adding your video and caption files, click the **Video tab** (Figure 1).
Figure 1
> Macro (anchor)
> Macro (anchor)
**How to add your video file**
Before uploading your video file, be sure it meets the required specifications.
View video file specifications
> Macro (excerpt-include)
Add your video files by typing the full URL or be selecting a video from your computer. More details on each method are below:
| **Add the full URL** | **Choose a file from your computer** |
| --- | --- |
| Type the **full URL of the corresponding video file** in the first textbox of the *Video* section (Figure 1.1). If choosing this option, the file must be hosted on a server and the ***full URL of the video file must be provided*** (example URL: [http://s3.amazonaws.com/media/help/my-video-file.mp4](http://s3.amazonaws.com/media/help/my-video-file.mp4)). | Click **Choose** to the right of the second textbox in each section to select a video file from your computer (Figure 1.2).
**If choosing this method, you must remain on the tab while the "Uploading" status is in progress after saving the page. **Navigating away from the page will cancel the upload process. Subsequent ingestion status states are not affected.
As the video ingests and the proper profile is being detected by the system, a status displaying the label "*Detecting"* appears. In the case that auto-detection fails, an informational error message is displayed, along with the video profile select box. Manually select a video profile from the profile select box and proceed with the ingestion. |
| (*click image to enlarge*)
 | (*click image to enlarge*)
 |
> ⚠️ ### Note about PBS temporary S3 storage
> ⚠️
> ⚠️ If neither of the upload options listed above works for you, many stations and producers use the direct file upload method to ingest video and caption files in Media Manager, or have a hosting service to generate upload URLs (as shown below). While these methods are preferred, PBS offers a temporary S3 hosting solution, if necessary.
> ⚠️
> ⚠️ The PBS S3 ingest bucket should only be used to generate temporary URLs for video and caption file ingestion in Media Manager, and should not be used for other purposes, or for long-term storage.
> ⚠️
> ⚠️ Files in the PBS S3 ingest buckets that are older than 30 days will be removed automatically. As a reminder, files successfully ingested in Media Manager are stored in a *separate archive bucket*, so the 30-day clean-up for source files in the ingest bucket does not affect availability. In other words, the ingest bucket is only used for the source file ingestion process.
> ⚠️
> ⚠️ Please [contact PBS Support](https://digitalsupport.pbs.org/support/tickets/new) with questions or access requests.
> Macro (anchor)
**How to add caption files**
> ⚠️ **Accepted file formats: DFXP, SMPTE-TT, and SCC. ****[View more about closed captioning](https://docs.pbs.org/space/MM/5344210/Closed+Captioning)**
**The FCC requires that you have a closed captioning file in the same language as your video's primary audio track language. **If the caption file language does not match the primary language of the video file, you cannot publish your asset (unless a valid caption justification is provided).
*Example: If the primary language of your video is English, your caption file must be in English. If your video is in Spanish, your caption file must be in Spanish. *
[Learn more about adding multiple captions](https://docs.pbs.org/space/MM/5343793/Assets#Assets-multiplecaptions)
1. Select your caption language from the select box.
2. Add your caption files in one of the following ways:
| **Add the full URL** | **Choose a file from your computer** |
| --- | --- |
| Type the **full URL of the corresponding caption file** in the first textbox of the *Closed Captioning *section (Figure 1.1). If choosing this option, the file must be hosted on a server and the ***full URL of the caption file must be provided*** (example URL: [http://s3.amazonaws.com/media/help/my-video-file.mp4](http://s3.amazonaws.com/media/help/my-video-file.mp4)). | Click **Choose** to the right of the second textbox in each section to select a caption file from your computer (Figure 1.2). |
| (*click image to enlarge*)
 | (*click image to enlarge*)
 |
- If a caption file is required (for publishing) and you have a valid (per FCC) justification for why it's not provided, click the **checkbox **next to ***Or, provide valid caption justification*** (Figure 2.1).
- Click the **radio button** next to the justification that applies to your video (Figure 2.2). If none of the listed options fits your needs, click **Other** and in the textbox provided, manually type the **reason for not ingesting a caption file**.
Figure 2
**Caption offset correction feature**
> ℹ️ This feature targets a particular scenario which results in a failed caption ingestion. This pertains to uploaded SCC caption files which are invalid due to a start time that is *advanced by one hour (*this means the captioning and video/audio timing is mis-aligned by one hour.)
> ℹ️
> ℹ️ This timing is common (and valid) for SCC caption files used for broadcast, but it needs to be corrected (time shifted back by one hour) before getting uploaded in Media Manager, for streaming.
> ℹ️
> ℹ️ **How it works:** If an SCC caption file is uploaded in the console with the (invalid) one-hour advanced start time, an error message displays and presents the user with an option to allow Media Manager to programmatically correct the caption timing (shift it back one hour), and re-ingest the file. Alternatively, the user can choose to correct the file themselves and re-upload it at a later time.
> ℹ️
> ℹ️ If the user elects to proceed with the process, the caption file archived on S3 will be the corrected version. This is done so that if the user chooses to reingest the file again at a later time, the corrected one will be used without error.
> ℹ️
> ℹ️ This feature is available in the MM console, but not in the API.
> ℹ️
> ℹ️ :warning: **Important: ****If the user chooses to proceed with the automatic offset correction feature, it’s imperative that they subsequently verify the audio and closed captioning are accurately synced throughout the video, after ingestion is complete. Media Manager cannot verify synchronization, so this step must be completed to discharge our legal due diligence responsibility.**
**Saving your video and captions**
- Now that you have uploaded your video and closed captioning files, click **Save **to save the page (Figure 3.1).
- To auto-publish your video file, click the **Auto publish checkbox **to the left of the Save button (Figure 3.2). When toggle is set to ON, your asset will publish automatically when all files have successfully ingested. See below to learn more about the auto-publish feature.
Learn more about auto-publish
#### What is auto-publish?
The auto-publish feature ensures that once all necessary files have been successfully ingested, your asset will automatically publish. This means that you can upload your video file (and caption file if applicable) and walk away during the ingestion process to do other things. You must check back in on the process in case any errors occur during ingestion. If errors occur, the process will stop and your asset will not publish until the errors are corrected.
#### What if I leave my computer and the asset encounters an error?
It's very important to remember that when you are using the auto-publish feature, ***you must**** ****be diligent about checking the ingestion status***. If ingestion fails, an error message displays in the console and your asset does not publish. You need to manually fix the errors and republish the asset by clicking the **Publish** button. Refer to the publish status to see if everything successfully ingested and published.
Figure 3
- As the file transcodes, the *Status *column updates with the percentage of completion (Figure 4.1).
- When the files have fully ingested, the *Status *column displays ***Ingestion Complete*** (Figure 4.2).
Figure 4
- When the files have completed ingestion and transcoding, the Status column displays *Ingestion Complete* (Figure 5.1).
- **Refresh the page** (Figure 5.2). In this example, we are right-clicking our mouse and clicking **Reload**.
> ⚠️ **If the *****Status *****column does not display Ingestion Complete after a few moments, refresh the page. ****If ingestion fails, click the Save button again.**
Figure 5
- When ingestion is complete, the following features are available under the Actions column:
- > Macro (inline-media-image)
- **File details.** Source and Archive URLs are listed here, along with all output files (Figure 6.1). [Learn more about output files](https://docs.pbs.org/space/MM/5343793/Assets#Assets-output)
- -** Replace file. **The video and closed captioning files can be replaced at any time without disrupting the viewer experience (Figure 6.2). [Learn more about replacing files](https://docs.pbs.org/space/MM/5343793/Assets#Assets-replace)
- - **Reingest file.** If there is an issue with the video file, try reingesting it (Figure 6.3). (This is not available for caption files)
- - **Delete file. **Deletes the file (Figure 6.4).
Figure 6
> Macro (anchor)
**How to add multiple caption files**
Because the FCC requires that you have a closed captioning file in the same primary language as your video's audio, you may need to upload more than one caption file. [Click here to learn how to change your video's primary audio](https://docs.pbs.org/space/MM/5343793/Assets#Assets-changeaudio)
This section shows you how to ingest additional caption files.
- Beneath your existing caption file, click** Add Caption** (Figure 1).
> ℹ️ Your existing, or primary, caption file must match the primary audio of your video file.
Figure 1
- The additional language option (in this example, Spanish) displays in the textbox at the top of the *Add Closed Captioning* section (Figure 2.1).
- When more languages are added to Media Manager, click the **downward-facing arrow** on the right side of the textbox to display all additional language (Figure 2.2).
- When finished, click **Save **to ingest the caption file (Figure 2.3).
> ℹ️ Don't see the language you need? [Submit a support ticket](https://digitalsupport.pbs.org/support/tickets/new)
Figure 2
- Both caption files display under the Language column (Figure 3).
Figure 3
- When a viewer watches your video, they can access the captions by clicking the **CC button **in the bottom right side of the video (Figure 4.1).
- They should click a **language** from the list of available languages that displays (Figure 4.2).
- The captions display on the video in the selected language (Figure 4.3).
Figure 4
> Macro (anchor)
**Transcripts**
See where your transcript file displays in Media Manager
- After your caption file has successfully been ingested, click the** Information icon** in the *Actions *column of the Closed Captioning section (Figure 1).
Figure 1
- In the* Output Files *section, the transcript file displays at the bottom of the list (Figure 2).
Figure 2
See where users can access the transcript on an episode page
Transcript files are automatically generated using ingested (or reingested) caption files. For each language provided in the caption files, a corresponding transcript file is generated in the same language.
In the console, the transcript URL/s are provided (when available) in the caption details area.
**Important notes about transcript files:**
1. Beginning February 2023, transcripts have been generated for all new caption file ingests. Prior to that date, transcript file coverage is not complete, but they are available for many full length national and KIDS video assets.
2. Clients using the transcript files are responsible for making any necessary encoding conversion changes to accommodate special characters, such as those found in some non-English caption and transcript files. (This is already the case with our output VTT caption files.)
3. Transcript files do not contain timestamps.
> Macro (anchor)
**How to change the primary audio of your video**
For videos that were** added to Media Manager after April 2021**, you can change the video's primary audio language using the following steps. For **videos ingested before April 2021**, please [submit a support ticket](https://digitalsupport.pbs.org/support/tickets/new) if you need the primary language changed.
- After your video has been ingested, click the** information icon** (Figure 1).
Figure 1
- Click the** Language dropdown menu** and click the **language** you want to assign as the primary language (Figure 2).
Figure 2
- Save the page.
> Macro (anchor)
**Output files**
- Click the icon to display the output files (Figure 1.1).
- In the** ***Output Files* section, click the **user type** associated with the transcoded files you want to view to expand the list (Figure 1.2).
| **Audience** | **Description** |
| --- | --- |
| **Public** | Files that display as videos available to everyone for an allotted period of time. |
| **All Passport Members** | Files that display as videos available for a specific window of time and available only to PBS Passport members. |
| **Your Station’s Passport Members** | Files that display as videos available for a specific window of time and available only to the station(s) Passport members. |
| **Trick Play** | Files generated to surface preview thumbnail images when users scrub forward/backward within a video. For now, the files generated are supported by Roku only, however, you can see the trick play feature in your [video preview](https://docs.pbs.org/space/MM/5343793/Assets#Preview). [Learn more about trick play on Roku](https://developer.roku.com/docs/developer-program/media-playback/trick-mode.md)
***Notes about Trick Play files: ***Only assets that have been created (or have had their video files re-ingested) since February 13, 2020 have trick play files generated. Trick play output files are generated and displayed in the console after video ingestion has fully completed. Older videos display a "No output files yet!" message in the Trick Play section of the output files. PBS is working to generate trick play files for older content. |
> ❌ **If there are no output files after a minute or so, refresh the page.**
Figure 1
- All transcoded files for the selected user type display (Figure 2.1). Click the **profile type** again to contract the results.
- Click the** X** in the upper right side of the page to close the menu (Figure 2.2).
Figure 2
> Macro (anchor)
**How to replace video and closed captioning files**
Live replace is a feature that enables you to replace a video and/or caption file without disrupting the viewing experience. While the file replace is in progress, viewers continue to access the video and captions that are currently live and can do so until the their cache has cleared or they begin a new session. For users who keep the original video screen open, or have paused playback for a period of time, the original file remains available for up to a day after the replacement is complete.
- To begin replacing your files, click the **pencil icon** to surface the fields where you can add a new file (Figure 1).
Figure 1
- Add the **file URL** in the textbox or click **Choose** to select a file from your computer (Figure 2.1).
- Click **Save** (Figure 2.2).
> ⚠️ **You can replace video and caption files simultaneously. **
Figure 2
- While the file replace is in progress, information for both the original and new files displays. When the new file has fully ingested, a message indicating so displays at the top of the page (Figure 3.1) and Ingestion Complete displays to the right of the new file name (Figure 3.2). Click the** information icon** ( ) to view file details.
- Refresh the page to remove the old file from view so that only details for the new file display (Figure 3.3).
> 📝 **What to do if a file fails**
> 📝
> 📝 If a replaced file fails ingestion for any reason, you will be prompted to cancel the replace (returning to the original file), or re-try the ingestion.
> 📝
> 📝 - Click **Cancel** to cancel the entire operation
> 📝 - Click **Try Again** to try adding a new file again
See what this looks like
Figure 3
### Support for Audio Description and Secondary Languages
What is Audio Description?
Audio Description (AD) is additional audio content, inserted as a narrative between the dialogue and other program sounds, which describes visual aspects of the video that may not be accessible to some visually-impaired users. Audio Description is provided as a separate track, and users can choose to turn it on in addition to the primary audio track.
**Media Manager supports video source files that include *****one***** *****or more***** audio tracks.** ([See Full Specs](https://docs.pbs.org/space/MM/5343887/Video+%26+Audio+Specs).)
For example, the video source file may have English as the primary audio track, and there could be additional tracks included for English Audio Description (AD), and other languages such as Spanish, French, etc.
At this time, not all PBS platform players can support audio track selection, but this will be improved over time. [See Full Specs](https://docs.pbs.org/space/MM/5343887/Video+%26+Audio+Specs) to get more information about player support.)
Detected audio details are displayed for videos ingested on/after April 12, 2021 (when the support for multiple audio tracks was introduced). This can be found in the expandable Details area for the video file on an asset's Video tab.
> 📝 For videos ingested prior to the feature release, the audio details **will not be displayed in the console**. In the future, we will determine how to handle populating the audio details for pre-existing video files. Stay tuned.
At this time, Media Manager only supports uploading a single closed captioning file, regardless of the number of audio tracks.
Get the [Full Specs](https://docs.pbs.org/space/MM/5343887/Video+%26+Audio+Specs) and learn more about uploading video files containing multiple audio tracks.
### Images
The image section of the console is where the image that represents your video across PBS platforms and serves as the video player placeholder is assigned.
#### **Image guidelines**
> ⚠️ **DO NOT USE the "Asset Original" image profile. This is a deprecated profile and is not used on any PBS platforms. It will be removed in the future.**
- **Media Manager requires (for publishing) the ingestion of one "Mezzanine 16x9" image file per asset, if the corresponding video file is also 16x9.**
- **The .jpg image format/extension is strongly recommended, as it will be size-optimized for streaming.**
- A mezzanine image is defined as an image with a 16:9 ratio. Common pixel dimensions include: 1920x1080, 1280x720
- Only one image profile per asset is allowed.
Although other image profiles are available in the console, the Mezzanine 16x9 is typically the only profile used. The following table displays each available image profile and where it should or should not be used.
| **Image Profile** | **Used for** |
| --- | --- |
| **GA Mezzanine 16x9** | GA videos (local and national) |
| **Kids Mezzanine 16x9** | KIDS videos |
| GA Mezzanine 4x3 | Use only if corresponding video is 4x3 |
| Kids Mezzanine 4x3 | Use only if corresponding video is 4x3 |
| Asset Original | Do not use |
#### How to add your image file
- Click the **Images tab** (Figure 1).
Figure 1
- Click the** blue Choose button** to browse for an upload an image from your computer (Figure 2.1).
- The **image profile** select box should pre-populate with the necessary 16x9 Mezzanine option, based on whether the video belongs to a GA or KIDS show (Figure 2.2).
- When finished, click **Save** (Figure 2.3).
Figure 2
- To change your image, click the **pencil icon** under the Action column on the right side of the page (Figure 3.1).
Figure 3
- Your current image information displays (Figure 4).
Figure 4
- Click the **blue Change button** or **anywhere in the textbox** to select another image and click the **profile dropdown menu** to select the **associated profile (if necessary)** (Figure 5.1).
- Click **Save** (Figure 5.2).
Figure 5
- Your new image displays (Figure 6.1).
- To delete the image, click the** trashcan icon** located in the Actions column on the right side of the page (Figure 6.2).
> ❌ **The trashcan icon deletes your image only while the red Delete button in the lower right side of the page deletes your entire asset.** ***Be careful!***
Figure 6
- Click **Yes, I'm sure** to complete the deletion (Figure 7.1).
- Click **No, take me back** if you want to keep the image (Figure 7.2).
Figure 7
- Your image has been deleted. Add another by following the same steps listed above (Figure 8).
Figure 8
### Chapters
#### What are chapters?
Chapters are short descriptions of individual segments throughout the duration of a video. When a user hovers the mouse over the tickmarks aligned along the chapter timeline at the bottom of the video screen, the title of each chapter appears, giving the user an idea of what is included in each particular short segment, or chapter. These chapter titles help the viewer track the progression of the video and enable them to skip to a particular chapter of interest by clicking a tickmark.
Take a look
| **Admin screen** | **Definitions and Examples ** |
| --- | --- |
|  | > Macro (nested-table) |
### Preview
Click the **Preview tab **to view the status of different parts of your asset, access the Partner Player code, and see a preview of your video. See what has been successfully ingested, which files are missing, and review your asset's metadata. In the Preview Video section, click the** play button** to preview the video, as well as the trick play feature, to see how it will look when it is live.
The Preview tab is particularly helpful if you encounter difficulties when publishing your asset. Review to see if crucial elements are missing and preventing you from successfully publishing your asset. The following are some notes about the Preview tab:
- The Title section contains a clickable link only after the asset has been published.
- Click Get Player Embed Code to access the Partner Player code. This code enables PBS producers to embed your asset. [Learn more about the Partner Player](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5343811)
- The Preview Video feature is only available after you have successfully added a video file to your asset.
- Move your mouse along the video scrub bar to view the trick play feature. [See how this looks](/wiki/download/attachments/5343793/trick-play.mp4?version=1&modificationDate=1694538444209&cacheVersion=1&api=v2)
- The Publish button in the upper right corner is only clickable when all required elements have been added to your asset.
- You can find some of the same information in the persistent status bar.
- Use the following shortcut keys to make viewing in the Preview Player easier:
| **Key** | **Function** |
| --- | --- |
| right/left arrows | move video forward/backward by five seconds |
| up/down arrows | control volume |
| space bar | pauses/plays video |
| “m” key | toggles mute on/off |
| “c” key | toggles captions on/off (selects the first language if there are multiple options) |
| “f” key | toggles full screen mode |
View the preview tab for a successfully published asset
*Click image to enlarge*
## Extras
An Extra is a type of Video Asset that can be associated with a [Franchise](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5343789), [Show](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5343796), or [Season](https://pbs-docs.atlassian.net/wiki/spaces/MM/pages/5343800). Extras can be Clips or Previews only (no Full Length Episodes) and have no associated ads. These assets appear on [PBS.org](http://PBS.org) by scrolling down a show page to the Clips and Previews or Extras sections. After you have clicked the Extras tab, the steps for creating a preview or clip exactly mirror the steps involved when creating a preview or clip from the Assets tab.
> ✅ **Want to use your asset as the preview for your show on PBS.org? ****[Click here to learn how](https://docs.pbs.org/space/MM/5343796/Shows#Featured-Preview-Content-ID)**
- From a Franchise, Show, or Season page, click the** Extras tab** (Figure 1).
Figure 1
| **Franchise** | **Show** | **Season** |
| --- | --- | --- |
|  |  |  |
- Click **Create Extra** (Figure 2).
Figure 2
- Click the **Object Type dropdown menu** and click **Preview** or **Clip** (Figure 3).
Figure 3
- The Slug is prefilled but when you type the **Title** in the Title textbox** **(Figure 4.1) the slug automatically reformats in the Slug textbox to fit the new title (Figure 4.2).
- Click **Save** (Figure 4.3).
> ⚠️ **From this point, create your Extra in the same way an ****[Asset is created](https://docs.pbs.org/space/MM/5343793/Assets#How-to-create-a-video-asset)****.**
Figure 4
## How to unpublish an asset
Unpublishing an asset removes the asset from public view. Unpublishing an asset can also be useful when you want to hide a season without deleting it. Seasons, episodes, specials are only visible when they contain published assets. This section shows you how to unpublish your assets.
- Assets that are published display a green checkmark next to Published along the top of the asset (Figure 1.1).
- Click the **Unpublish button** in the upper right corner of the page (Figure 1.2).
Figure 1
- A red X displays next to Published along the top of the asset, indicating that it is unpublished (Figure 2.1).
- When the asset is unpublished, the button in the upper right side displays "Publish" (Figure 2.2). Click the **Publish **button to publish the asset.
Figure 2
## How to delete an asset
You can delete an asset from the Media Manager dashboard by using the dropdown features that expose layers of objects.
- Click the **right-facing arrow** to the left of the title of the season that holds the asset you want to delete.
- Click the **plus sign** next to the title of the episode that holds the asset you want to delete.
- Click the** trashcan icon** to the right of the title of the asset you want to delete.
- Click ***Yes, I'm sure**** *to confirm deletion.
- The asset has been deleted.
Figure 1
*(click image to enlarge)*
## How to reingest a video file
In some cases where, for example, an older video is lacking some of the modern output encodings, or if an output encoding fails to get generated during the initial transcode process, you can reingest the existing video file. Only video files that have an associated archive file available at its S3 location can be reingested. If the archived video file is glacierized in S3, the reingestion process takes about 5-12 hours to complete. The process is automated and video playback is not disrupted during the reingestion process.
Reingesting a video file is not intended for general troubleshooting or for bulk tasks. Please check the following before reingesting a file:
- View the video on multiple devices and browsers
- Check your internet connection to see if you have a slow connection
- Verify that the video is published
- Verify that the caption files are correctly ingested
- Verify that the output files have been generated
The steps below illustrate how to reingest a video file in Media Manager.
What does glacierize mean?
When a video is glacierized, it goes into an Amazon “Glacier” storage service that is optimized for infrequently used data, or "cold data." This allows us to store archived video files at a reduced cost, and only request access to them as needed. Getting access to glacierized files can take up to 12 hours. All video archive files get stored in Amazon Glacier shortly after being ingested in Media Manager.
- In the Media Manager console, go to the episode of the show that holds the video file you want to reingest and click the **Video tab** (Figure 1.1).
- In the Video section, under the *Actions *column on the right side of the page, click the** orange circular left-facing arrow** (Figure 1.2).
Figure 1
- To confirm that you want to initiate the ingestion process, click **Yes, I'm sure** in the bottom right side of the page (Figure 2).
Figure 2
- In the bottom right side of the screen, click **Save **(Figure 3.1).
- The status column reflects the state of the ingestion process (Figure 3.2).
Figure 3
- Once the video has completed ingestion, an *Ingestion Complete* confirmation label displays (Figure 4.1).
- Another confirmation indicating that the file has been reingested displays in a green bar and you are instructed to refresh your browser to update the page (Figure 4.2).
Figure 4
- Depending on your browser, you can refresh the page a couple different ways. The example below shows refreshing the page in a Chrome browser by right clicking your mouse and clicking **Reload** (Figure 5.1) or clicking the** refresh button** in the upper left side of the browser (Figure 5.2).
Figure 5
- After the page has been refreshed, the Status column displays *Ingestion Complete*, indicating that the video has been successfully reingested and can be played on PBS apps (Figure 6).
Figure 6
## How to reingest a caption file
Reingesting your caption file can be useful as a troubleshooting step. An example of this is, for instance, if you've uploaded video and caption files, but the captions are not displaying in the player. Use the caption reingest feature to see if it fixes the issue.
After the reingest has completed, we recommend testing in the [preview player](https://docs.pbs.org/space/MM/5343793/Assets#Preview). This is the fastest method and it can be done right in the console.
See where you can test your captions in the Preview tab
The steps below illustrate how to reingest a caption file in Media Manager.
- In the Closed Captioning section of your asset, click the** reingest icon** in the Actions column (Figure 1).
Figure 1
- A message displays, asking you to confirm the reingestion. Click ***Yes, I'm sure*** (Figure 2).
Figure 2
- A new row titled, *New Closed Captioning* displays and indicates that the file is ready to be ingested (Figure 3).
Figure 3
- After ingestion is complete, the original caption file has been removed (Figure 4.1).
- The newly ingested file displays an* Ingestion Complete* label (Figure 4.2).
- An alert displays, indicating that the file has successfully completed and you should** refresh the page** to update your console's display (Figure 4.3).
Figure 4
- After refreshing the page, the newly ingested caption file displays (Figure 5).
Figure 5
