Syncing your content into Pressly via RSS

Pressly offers a simple way for publishers to integrate their existing content through RSS feeds. The majority of content management systems (CMS) today offer RSS and/or Atom support - such as Wordpress, Tumblr, Adobe CQ and on. Although Pressly can parse most out-of-the-box RSS / Atom feeds, for best results please follow the guide below.

Pressly leverages the following widely-adopt open standards:

  • RSS 2.0: The standard syndication format for content on the web. 
  • Content extension: Add full HTML encoded content into RSS.
  • Media RSS extension: Assets such as images, video, and audio are included using this standard extension to RSS.

Example Feed

Below is a sample RSS 2.0 feed with two articles using the content and media namespace extensions.

View full RSS feed

Feed Structure

Channel - A stream of content from a site

  • <title>: The name of the source feed (ie. site title)
  • <link>: The canonical URL to the source website
  • <description>: A plain-text description of the content in the source site [optional]
  • <language>: The language the channel is written in. See supported lang codes. [optional]
  • <item>: A channel can contain any number of items. An item represents the content in the feed. See "Item" below.

Item - An item element represents the content pieces in the feed (ie. an article)

  • <title>: The title of the article
  • <link>: The canonical URL to the article
  • <guid>: A string unique identifier for the article defined by the source. The guid is used to sync content updates to the content.
  • <pubDate>: The date of the article's publication, in RFC822 format.
  • <description>: A short, plain-text summary or abstract of the article. [optional]
  • <dc:creator>: The author's name of the article. Use multiple <dc:creator> elements for multiple authors. [optional]
  • <media:content> and <media:group>: URLs and metadata for image, video and audio assets. See Image, Video and Audio sections below.
  • <content:encoded>: The full HTML content of the article. See Content Markup section below.

Content Markup

The <content:encoded> element contains the entire HTML contents of an article. All HTML must be properly escaped; the recommended way to do this is by wrapping the content within a CDATA section.

<content:encoded> can include:

  • Heading tags such as <h1>, <h2>, etc.
  • Lists via <ul> or <ol>
  • Paragraphs via <p>
  • Block quotes via <blockquote>
  • Inline images and videos via <img> and <video>
  • Inline YouTube, Vimeo, Brightcove and SoundCloud support via <iframe> or <embed>

Unsupported elements:

  • <script>, <style>, <canvas>

Inline Image, Video and Audio Assets

Media assets referenced in markup within the <content:encoded> element are automatically downloaded and cached. The following filetypes are supported:

  • Images: JPEG, GIF, PNG
  • Video: MP4 (H.264 encoded), YouTube, Vimeo or Brightcove embeds
  • Audio: MP3, or SoundCloud embeds

Assets may also be included into the feed by adding <media:content> or <media:group> elements within the <item> tag. Any assets referenced within the <content:encoded> markup will be merged with <media:content> elements if the URL is an exact match. The position within the content will be preserved, but metadata and alternate resolutions specified within <media:content> will take priority.

Media

The Media RSS (mRSS) extension is used to enhance the basic RSS specification to add support for: images, videos and audio. Additional information on the mRSS spec is available here.

Images

<item> <!-- Full markup omitted for brevity --> <media:content url="http://media.musicto.com/2013/01/15/weeknd.jpg" type="image/jpeg" medium="image" width="1024" height="768"> <media:description type="plain">Weeknd cover album art</media:description> <media:copyright>Sara Foto</media:copyright> </media:content> </item>

The <media:content> element supports two sub-elements:

  • <media:description>: The image caption. Supported types are plain-text (type=plain) or HTML (type=html)
  • <media:copyright>: Copyright information or credit for the author of the asset

The <media:group> element can be used to group the same images of varying sizes:

<item>
  <!-- Full markup omitted for brevity -->
  <media:group>
    <media:content url="http://media.musicto.com/2013/01/15/weeknd-small.jpg"
                   type="image/jpeg" medium="image" width="300" height="200">
      <media:description type="plain">Weeknd cover album art</media:description>
      <media:copyright>Sara Foto</media:copyright>
    </media:content>
    <media:content url="http://media.musicto.com/2013/01/15/weeknd.jpg"
                   type="image/jpeg" medium="image" width="1024" height="768">
      <media:description type="plain">Weeknd cover album art</media:description>
      <media:copyright>Sara Foto</media:copyright>
    </media:content>
  </media:group>
</item>

Videos

As with images, video assets are included via mRSS like so:

<item>
  <!-- Full item markup omitted for brevity -->
  <media:content url="http://media.musicto.com/weeknd-balloons.mp4"
                 type="video/mp4">
    <media:description type="plain">
      Video of The Weeknd - House of Ballons, live in concert
    </media:description>
    <media:thumbnail url="http://media.musicto.com/2013/01/15/weeknd-small.jpg" width="300" height="200" />
    <media:copyright>Weeknd</media:copyright>
  </media:content>
</item>

The <media:content> element supports a few sub-elements for videos:

  • <media:description>: Specifics the video caption
  • <media:thumbnail>: The poster image for the video
  • <media:copyright>: Copyright information or credit for the author of the asset

YouTube and Vimeo videos can be embedded directly into the <content:encoded> element:

<item>
  <!-- Full item markup omitted for brevity -->
  <content:encoded><![CDATA[
    <p>Check out this great video</p>

    <iframe src="http://www.youtube.com/embed/VIDEO_ID" width="420" height="315"></iframe>

    <p>... rest of article content ...</p>
  ]]></content:encoded>
</item>

Audio

Just like images and videos, audio is integrated via mRSS by specifying the "type" of the <media:content>.

<item>
  <!-- Full item markup omitted for brevity -->
  <media:content url="http://media.musicto.com/weeknd-balloons.mp3"
                 type="audio/mpeg">
    <media:description type="plain">
      Weeknd - House of Ballons track
    </media:description>
    <media:thumbnail url="http://media.musicto.com/2013/01/15/weeknd-small.jpg" width="300" height="200" />
    <media:copyright>Weeknd</media:copyright>
  </media:content>
</item>

Alternatively, audio can be directly embedded into the <content:encoded> element by using the new HTML5 <audio> tag.

Feedback and Knowledge Base