Set up a new import feed

Create a feed that you can use to import content in bulk using MRSS feeds



If you have a valid Media Really Simple Syndication (MRSS) feed for your collection of videos, you can bulk import those videos and associated content into your account. Using your dashboard, you can upload all your videos, register your videos, and import metadata associated with your videos in one single workflow.


πŸ”‘

If you are a developer or have developer resources, you can use the Management API to set up an MRSS import feed.



Implementation

12021202

Import settings screen


You can set up, define, activate, review, and delete an import feed from your JWP dashboard. The following sections explain how to complete these tasks.


🚧

Before bulk importing your videos, be sure to review the FAQs at the end of this article and limit your MRSS feed to 1,000 videos. If you have more than 1,000 videos in your feed, split them into groups of 1,000 or less.

Additionally, any configuration changes will not apply retroactively to assets that have already been ingested.


Use the following steps to set up a new MRSS import feed:

  1. From the Import page, click Add Source. The Import Source panel appears.
  2. Enter the Media RSS Feed URL.
  3. Enter the Title of the feed.
  4. Choose how the content should be hosted with JWP:

    • Yes, host and register this media (recommended): This option uploads and registers each video to your account. You can share, edit (including video length, captions, metadata), recommend, monetize, and analyze each video.

    • No, don't host media on import, just register it.: This option only registers each video with your account. You can share, edit only video metadata, recommend, and analyze each video. This option limits access to various data products and features. Use this option when adding videos with embedded captions to your library. Videos using this option are not subject to monthly storage or streaming limits.

  5. Click Add Source. The new feed appears on the Import page with an Inactive Status.
  6. Click the name of the new feed. The feed details page appears.
  7. Click the Media Import toggle to OFF.
  8. If authentication is required to access the content to import, set the credentials.
  9. (Optional) Adjust the metadata and tag settings:
  10. Click SAVE.


MRSS Feed Authentication

20582058

Set credential screen


Some feeds have security enabled to prevent someone from gaining unauthorized access.

If the MRSS feed you want to import requires authentication, use the following steps to set the credentials to enable access to the media in the feed:

  1. Under Source URL, click Set Credentials. The Set Credentials popup window appears.
  2. Enter the Username and Password for the MRSS feed.
  3. Click Submit. The import system will use these credentials for authentication.


Content-Level Metadata

11141114

Content-level metadata setting


If the imported media has media:description, media:text, media:thumbnails, or pubDate defined in the feed, this information is used to populate the relevant metadata for the media.

The following table shows how the feed data for the media is mapped to the media metadata option in your JWP dashboard.

JWP Content-Level MetadataMRSS Element
Captionsmedia:subTitle
Descriptionmedia:description
Publish DatepubDate
Thumbnailsmedia:thumbnails

If you prefer to prevent JWP from automatically mapping the feed data to the media metadata, use the following steps:

  1. Scroll to the Content-Level Metadata section.
  2. Click the checkbox next to the media metadata to be excluded during the import for each media. Since all media metadata checkboxes are selected by default, this step unchecks the metadata to exclude.


Tags

11001100

Tags and Content-Level Tags settings

Tags

A tag is a label applied to a media. When applied to a media, tags can be used for searching, sorting, and filtering JWP playlists.

Use the following steps to add tags to all videos that are imported from this MRSS feed:

  1. On the Tags tab, choose to add a Single tag or Multiple Tags.
  2. Enter the tag information:
    • For a Single tag, enter the tag.
    • For Multiple Tags, enter a comma-separated list of tags.
  3. Click Add.

Content-Level Tags

If the imported media has media:category, media:credit, media:keywords, or media:tags defined in the feed, the information of each element is used to create tags for the imported media.

If you prefer to prevent JWP from automatically adding these tags to imported media, use the following steps:

  1. Scroll to the Content-Level Tags section.
  2. Click the checkbox next to the tag information to be excluded during the import for each media. Since all tag checkboxes are selected by default, this step unchecks the tag information to exclude.


Advanced Content-Level Tags

11041104

Advanced Content-Level Tags


Advanced Content-Level Tags are created from the values of custom namespaced elements in an MRSS feed. The value of an element is then applied to each media as a tag.

For example, the following is an example of a custom namespaced element from an MRSS feed.

<jp:locationType>Mountains</jp:locationType>

The namespace element (jp:locationType) can be added in the Advanced Content-Level Tags section of your JWP dashboard. For all imported media containing the jp:locationType element, the value of the element is applied as a tag to the media. Using the previous example, a Mountains tag would be applied to the media.

The tags created from custom namespaced elements can be used for searching, sorting and filtering JWP playlists.


πŸ“˜

On the Custom Content-Level Tags tab in the MRSS Element text box, add the element name.


Use the following steps to add a advanced content-level tag:

  1. On the Advanced Content-Level Tags tab in the MRSS Element text box, add the element name.
  2. Click + Add.


Custom Parameters

11001100

Custom Parameters settings


Custom Parameters allow for custom information to be imported with the JWP videos.


Custom Parameters

  1. Enter a Key and Value for each custom parameter that will be added to every video imported from this MRSS feed.
  2. (Optional) Click + Add to apply additional custom parameters.

πŸ’‘

You can click Prefill Property Parameters to add the default custom parameters of the property to a video.



Advanced Content-Level Custom Parameters

11081108

Advanced Content-Level Custom Parameters settings


Advanced Content-Level Custom Parameters are created by parsing custom namespaced elements in an MRSS feed and importing it as a custom parameter on the associated video.

Use the following steps to set Advanced Content-Level Custom Parameters:

  1. On the Advanced Content-Level Custom Parameters tab in the MRSS Element text box, add the element name.
  2. Click + Add.
<jp:locationType>Mountains</jp:locationType>

In this example, a custom parameter with the key locationType and value Mountains will be added to the JWP video.


🚧

There can only be one unique key per video. If there is more than one custom parameter for the media item with the same key, then only the first will be imported.

The custom namespaced values must be at the first level under the individual video element in the MRSS XML to be imported.

XML attributes are not used for the key or value of the custom parameter.



FAQs

Is there an MRSS specification?

Yes. The Media RSS Specification is maintained by the RSS Advisory Board.


What media formats are supported with MRSS feed imports?

While JWP can accept many media formats, we recommend uploading .aac, .mp3 .mp4, .ogg, or .webm files.

The following tables list all media formats that can be included in an MRSS feed. Rows denoted with an asterisk (*) are recommended formats that the player officially supports. Other accepted formats will be transcoded into an appropriate format when uploaded.

🚧

Be aware that neither an HLS nor DASH stream is supported in an MRSS feed.



Video Formats

Name Mime Type / Internet Media Type File Extension
* MPEG-4 video/mp4 .mp4
* WebM video/webm .webm
3GP video/3gpp .3gp
H.264 video/h264 .h264
Microsoft Windows Media video/x-ms-wmv .wmv
(excluding videos using MSS2 video codec)
MPEG video/mpeg .mpeg
MPEG transport stream video/MP2T .tsv
Ogg video/ogg .ogv
Quicktime video/quicktime .mov
(excluding videos using Apple Intermediate Codec)

.qt

Audio Formats

Name Mime Type / Internet Media Type File Extension
* Advanced Audio Coding audio/aac .aac
* MP3 audio/mpeg .mp3
* Ogg (Vorbis) audio/ogg .ogg
MPEG-4 Audio audio/mp4 .mp4a
WebM audio/webm .webm
Waveform Audio Format audio/wav .wav

πŸ“˜

You can read more about video preparation.




What’s Next