Platform DocsPlayers DocsRelease Notes
System StatusSubmit a CaseDashboard LoginContact Sales

<img src="https://img.shields.io/badge/%20-ALL-%2300B180" style="float:left"/><br />

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.



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.

<br />



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

<br /> <hr />

## Implementation

1202


Import settings screen

<br />

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.

<br />

<br />

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:<br /><br />

    • **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.<br /><br />

    • **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.<br /><br />

  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:

    • [Content-Level Metadata](🔗)

    • [Tags](🔗)

    • [Advanced Content-Level Tags](🔗)

    • [Custom Parameters](🔗)

    • [Advanced Content-Level Custom Parameters](🔗)<br /><br />

  10. Click **SAVE**.

<br /> <br />

### MRSS Feed Authentication

2058


Set credential screen

<br />

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.

<br /> <br />

### Content-Level Metadata

1114


Content-level metadata setting

<br />

If the imported media has the following items defined in the feed, this information is used to populate the relevant metadata for the media:

  • `media:description`

  • `media:text`

  • `media:thumbnail` <span style="font-size:12px">

    

    This applies only to JWP-hosted content. Non-hosted, registered content will not contain any thumbnail information.

</span>

  • `pubDate`

<br />

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
Captions`media:subTitle`
Description`media:description`
Publish Date`pubDate`
Thumbnails`media:thumbnail`

<br />

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.

<br /> <br />

### Tags

1100


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**.

<br />

#### 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.

<br /> <br />

### Advanced Content-Level Tags

1104


Advanced Content-Level Tags

<br />

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.


<br />
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.
<br />

On the  **Custom Content-Level Tags**  tab in the  **MRSS Element**  text box, add the element name.
<br />
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**.
<br />
<br />
### Custom Parameters
1100

Custom Parameters settings
<br />
Custom Parameters allow for custom information to be imported with the JWP videos.
<br />
#### Custom Parameters
  1. Enter a  **Key**  and  **Value**  for each custom parameter that will be added to every video imported from this MRSS feed.  
    
    Do not begin a key with a number. When a key begins with a number, invalid XML elements are introduced into the MRSS feed.
  2. (Optional) Click  **+ Add**  to apply additional custom parameters.
<br />

You can click  **Prefill Property Parameters** to add the  [default custom parameters](🔗)  of the property to a video.
<br />
<br />
### Advanced Content-Level Custom Parameters
1108

Advanced Content-Level Custom Parameters settings
<br />
**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**.

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

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.
<br />
<hr />
## FAQs
<details><summary><strong>Is there an MRSS specification?</strong></summary>
<br />
Yes. The <a href="http://www.rssboard.org/media-rss" target="_blank">Media RSS Specification</a> is maintained by the RSS Advisory Board.
<br />
</details>
<details><summary><strong>What media formats are supported with MRSS feed imports?</strong></summary>
<br />
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.
<br />
<br />
**Video Formats**
<table>
    <thead>
        <tr>
            <th> Name </th>
            <th> Mime Type / Internet Media Type </th>
            <th> File Extension </th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td width="34%"> <strong>* MPEG-4</strong> </td>
            <td width="33%"> <strong>video/mp4</strong> </td>
            <td width="33%"> <strong>.mp4</strong> </td>
        </tr>
        <tr>
            <td> <strong>* WebM</strong> </td>
            <td> <strong>video/webm</strong> </td>
            <td> <strong>.webm</strong> </td>
        </tr>
        <tr>
            <td> 3GP </td>
            <td> video/3gpp </td>
            <td> .3gp </td>
        </tr>
        <tr>
            <td> H.264 </td>
            <td> video/h264 </td>
            <td> .h264 </td>
        </tr>
        <tr>
            <td> Microsoft Windows Media </td>
            <td> video/x-ms-wmv </td>
            <td> .wmv<br /><em>(excluding videos using MSS2 video codec)</em> </td>
        </tr>
        <tr>
            <td> MPEG </td>
            <td> video/mpeg </td>
            <td> .mpeg </td>
        </tr>
        <tr>
            <td> MPEG transport stream </td>
            <td> video/MP2T </td>
            <td> .tsv </td>
        </tr>
        <tr>
            <td> Ogg </td>
            <td> video/ogg </td>
            <td> .ogv </td>
        </tr>
        <tr>
            <td> Quicktime </td>
            <td> video/quicktime </td>
            <td> .mov <br /><em>(excluding videos using Apple Intermediate Codec)</em><br /><br />.qt </td>
        </tr>
    </tbody>
</table>
<br /><br />
**Audio Formats**
<table>
    <thead>
        <tr>
            <th> Name </th>
            <th> Mime Type / Internet Media Type </th>
            <th> File Extension </th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td width="34%"> <strong>* Advanced Audio Coding</strong> </td>
            <td width="33%"> <strong>audio/aac</strong> </td>
            <td width="33%"> <strong>.aac</strong> </td>
        </tr>
        <tr>
            <td> <strong>* MP3</strong> </td>
            <td> <strong>audio/mpeg</strong> </td>
            <td> <strong>.mp3</strong> </td>
        </tr>
        <tr>
            <td> <strong>* Ogg (Vorbis)</strong> </td>
            <td> <strong>audio/ogg</strong> </td>
            <td> <strong>.ogg</strong> </td>
        </tr>
        <tr>
            <td> MPEG-4 Audio </td>
            <td> audio/mp4 </td>
            <td> .mp4a </td>
        </tr>
        <tr>
            <td> WebM </td>
            <td> audio/webm </td>
            <td> .webm </td>
        </tr>
        <tr>
            <td> Waveform Audio Format </td>
            <td> audio/wav </td>
            <td> .wav </td>
        </tr>
    </tbody>
</table>
<br />

You can read more about [video preparation](🔗).
<br />
</details>
<br />