Migrate your existing content into your Newsroom

Our data migration service offers the possibility to transfer existing content to the Newsroom. In order to do this we need to receive this content in an XML file, formatted according to the RSS 2.0 standard.

For your RSS feed to be imported by us, the following is required:

• The feed must be in valid RSS 2.0 format
• Images need to be either inlined in the body text or included in a media:content element
• Files that you want included in a download module need to be included in a media:content element as well
• 'Featured images' need to be added using an enclosure url element
• The full body text needs to be included in the item
• Make sure that any URL paths in the feed are absolute
• Image paths need to end in a file extension in order to be scraped and re-uploaded properly

If you have multiple languages in your account, each language requires its own RSS feed. As each language is imported separately, it's not possible to link translations of the same article to each other in the import process. For a bigger list of things to consider before the migration process, click here.

For a full example of a correct and validated feed, please see the Feed example section below.

Different nodes within an item in the feed explained:

Every content item (page, article, blog etc.) within your feed needs to be within an <item> node in the feed e.g. <item></item>
Within an item node, the following fields are accepted: (* = required)

• Date*
  This is the publication date of the content item
• Title*
  This is the main title of the content item
• Subtitle
  This is an optional subtitle of the content item.
• Full body text*
  This is the actual message of the content item. This message can contain HTML but in order to import it correctly it needs to be encoded or be encapsulated with CDATA tags. Also breaks should be added as "break" or "p" tags. Example:
  <![CDATA[<p>Your content here</p>]]>

• Summary
  This is an optional summary text of the content item
• Media
  Every content item can contain images and/or files. In order to import these correctly we need to group them in a so called media:group element. For an example see the Import Media instructions below
• Tags
  Every content item can contain as many tags as needed. These tags can then be used to connect modules or to generate RSS feeds. Multiple tags need to be comma separated: e.g. <category>Tag 1,Tag 2,Tag 3</category>. Make sure that existing tags are entered and formatted correctly.
• Featured image
  The platform makes use of Featured images which are shown in several modules such as the Headline module and are shown when shared across Social Media. We support one featured image per content item.
  Include a featured image as follows: <enclosure url="https://path-to-a-featured-image-of-this-content-item.jpg" length="0" type="image/jpg" />
• Link (URL)*
  This is the source URL of the content item location.

Import Media instructions

In order for our system to import media correctly, we need the provided feed to include media groups for each content item that includes images and/or files. Please see http://www.rssboard.org/media-rss for further reference.
You can add as many files within this group for every image or file that has to be imported. These files need to be a direct link to the video or image; embed codes or other types of links will not work.

Images and videos that are imported as a media group will be shown above the press article text, but below the title and the summary. Assets always need to be part of a (press release) item, a stand-alone feed that only contains images cannot be imported.

Example of a media group
This example shows a media group for a single content item that contains two images and a pdf file. These media group attributes (content URL, title, description) are the only ones currently supported.

<media:group>
  <media:content url="https://www.domain.com/images/logo.png">
    <media:title>Image 1 Title</media:title>
    <media:description>Image 1 Description</media:description>
  </media:content>
  <media:content url="https://content.domain.com/uploads/image.png">
    <media:title>Image 2 Title</media:title>
    <media:description>Image 2 Description</media:description>
  </media:content>
  <media:content url="https://www.domain.com/uploads/pdf-file.pdf">
    <media:title>PDF 1 Title</media:title>
    <media:description>PDF 1 Description</media:description>
  </media:content>
</media:group>

Feed example
This example shows a feed with all possible fields:

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/" xmlns:content="http://purl.org/rss/1.0/modules/content/">
<channel>
<title>Feed Title</title>
<link>https://www.domain.com</link>
<description>Feed description</description>
<pubDate>Wed, 21 Jun 2023 13:35:04 +0000</pubDate>
<item>
<title>Content Item Title</title>
<link>https://www.domain.com/safe-url</link>
<pubDate>Thu, 15 Jun 2023 20:51:41 +0000</pubDate>
<description>
<![CDATA[<p>Summary of this content item</p>]]>
</description>
<content:encoded>
<![CDATA[<p>Full text of content item</p>]]>
</content:encoded>
<media:group>
<media:content url="https://www.domain.com/images/logo.png">
<media:title>Image 1 Title</media:title>
<media:description>Image 1 Description</media:description>
</media:content>
<media:content url="https://content.domain.com/uploads/image.png">
<media:title>Image 2 Title</media:title>
<media:description>Image 2 Description</media:description>
</media:content>
<media:content url="https://www.domain.com/uploads/pdf-file.pdf">
<media:title>PDF 1 Title</media:title>
<media:description>PDF 1 Description</media:description>
</media:content>
</media:group>
<category>tag 1,tag 2,tag 3</category>
<enclosure url="https://path-to-a-featured-image-of-this-content-item.jpg" length="0" type="image/jpg" />
</item>
</channel>
</rss>