Set up a new import feed

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.

🔑

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

Implementation

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.

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:
   • Content-Level Metadata
   • Tags
   • Advanced Content-Level Tags
   • Custom Parameters
   • Advanced Content-Level Custom Parameters
     
     
10. Click SAVE.

MRSS Feed Authentication

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

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
  

  📘

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

• pubDate

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

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

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

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

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.

   ⚠️

   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.

💡

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

Advanced Content-Level Custom Parameters

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