To send content from an existing CMS to Pugpig automatically, an RSS feed is by far the simplest and most adopted approach. 

Our documentation contains numerous guides detailing requirements for a typical RSS feed. If you haven't already, it's advisable to read our RSS feed overview before reading this doc. Below you'll find an example of a feature-rich Full Fat RSS feed to help guide your feed structure.
 

Example RSS Feed

Below you'll see small feed containing one item to give a brief overview of typical standardised and custom fields to illustrate how you could send us data cleanly.

Be mindful that although our parser is quite flexible with what it will allow, if your feed is used for other purposes, you may need to approach this differently: 

<rss version="2.0"
  xmlns:content="http://purl.org/rss/1.0/modules/content/"
  xmlns:pp="https://www.pugpig.com/example-feed/"
  xmlns:media="http://search.yahoo.com/mrss/">

  <channel>
    <title>Example Pugpig Article RSS Feed</title>
    <link>https://www.pugpig.com/example-feed.xml</link>
    <description>The latest news from Pugpig.com</description>
    <lastBuildDate>Tue, 08 Apr 2025 09:14:58 GMT</lastBuildDate>
    <docs>https://validator.w3.org/feed/docs/rss2.html</docs>
    <generator>Pugpig RSS Feed Generator v1.2 (WordPress 6.4.2)</generator>
    <language>en</language>
    <ttl>5</ttl>
    <copyright>Copyright 2025 Pugpig. All rights reserved.</copyright>

    <item>
      <title>
        <![CDATA[This is a Simple Example Article]]>
      </title>
      <link>https://www.pugpig.com/permalink-structure</link>
      <guid isPermalink="false">7000225893</guid>
      <description>
        <![CDATA[This is a simple example article to illustrate how a typical article is sent to Pugpig via RSS.]]>
      </description>
      <content:encoded><![CDATA[<p>Lorem ipsum dolor sit amet ex ante. Sapien turpis ac dapibus class nam netus suspendisse magna augue quisque etiam. Lobortis donec suscipit in sociosqu risus nam nisl semper. Condimentum morbi integer ac aliquam fusce ridiculus ultricies magna iaculis. Augue donec tellus mus suspendisse ridiculus justo.</p><blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow"><blockquote class="wp-block-quote is-layout-flow wp-block-quote-is-layout-flow"><p><strong>Lorem ipsum dolor sit amet et euismod eu dictum efficitur quam quisque per praesent mollis</strong></p></blockquote><cite>blockquote  citation</cite></blockquote><p>Pulvinar iaculis suscipit tellus felis congue dictumst maecenas. Dictum posuere phasellus gravida integer natoque interdum a justo facilisis <a href="/">tempor parturient</a>. Felis sapien dictumst nascetur ante tempor. Morbi mus nulla sed rhoncus non volutpat elementum lacinia molestie metus quisque. Morbi pellentesque ad ligula himenaeos mi hendrerit. Torquent sapien consectetur porttitor vel curabitur nascetur egestas blandit. Inceptos aliquet nisi porttitor hac massa porta felis finibus. Aptent letius velit egestas amet pretium diam laoreet.</p><h2 class="wp-block-heading">Lorem ipsum dolor sit</h2><p>Accumsan curabitur habitant eleifend odio suscipit efficitur arcu. Nisl scelerisque class velit laoreet fames cubilia odio eros integer consectetuer magna. Ridiculus penatibus pretium vel fringilla placerat faucibus mattis. Sollicitudin semper curabitur conubia luctus lectus venenatis amet ipsum velit. Taciti pulvinar cubilia turpis ridiculus vehicula amet aenean senectus magna. Consectetuer placerat taciti ullamcorper natoque mauris faucibus bibendum convallis. Mauris finibus litora risus suscipit laoreet fames id vestibulum curae.</p><ul class="wp-block-list"><li>Lorem ipsum dolor sit amet</li><li>euismod eu dictum efficitur </li><li>quam quisque per praesent mollis</li><li>euismod eu dictum efficitur quam quisque per praesent mollis</li></ul><p>Efficitur molestie id ultrices mollis habitasse dui ullamcorper lectus feugiat vulputate. Dignissim nibh neque nullam morbi faucibus ac malesuada porttitor platea. Mus mollis lectus quisque sagittis ac efficitur consequat. Tempus malesuada enim metus nec lectus hac dolor nunc. Mus egestas cras nulla libero a praesent massa placerat suspendisse. Cursus proin sodales himenaeos gravida vestibulum eleifend quam. Finibus accumsan porttitor est facilisi pulvinar velit condimentum nulla. Pellentesque tincidunt eros velit augue non consequat cursus vestibulum.</p><hr class="wp-block-separator has-alpha-channel-opacity"/><p>Ex sit maecenas habitant elementum torquent taciti non consequat dolor. Mi montes ullamcorper tempor vel congue lorem felis consectetuer aliquam ac fusce. Pellentesque nunc nostra habitasse ante maximus blandit phasellus tellus elementum. Consequat sem taciti ultricies ullamcorper duis arcu risus pharetra. Conubia condimentum arcu fames tellus pellentesque sit. Interdum lacinia aliquam diam pellentesque curae leo sem montes dignissim.</p>]]></content:encoded>
      <pp:categories>
        <category>
          <name>News</name>
          <slug>news</slug>
          <colour>#0000FF</colour>
        </category>
        <category>
          <name>Politics</name>
          <slug>politics</slug>
          <colour>#0000FF</colour>
        </category>
      </pp:categories>
      <pp:authors>
        <author>
          <name>
            <![CDATA[Jane Boppert]]>
          </name>
          <bio>
            <![CDATA[Lorem ipsum dolor sit amet tristique ad mus. Phasellus consectetur dapibus sagittis viverra netus porta.]]>
          </bio>
          <headshot>https://www.pugpig.com/authors/jane-boppert.png</headshot>
        </author>
        <author>
          <name>
            <![CDATA[Adam Durrant]]>
          </name>
          <bio>
            <![CDATA[Lorem ipsum dolor sit amet tristique ad mus. Phasellus consectetur dapibus sagittis viverra netus porta.]]>
          </bio>
          <headshot>https://www.pugpig.com/authors/adam-durrant.png</headshot>
        </author>
      </pp:authors>
      <pubDate>Tue, 08 Apr 2025 09:49:03 +0000</pubDate>
      <updated>Tue, 08 Apr 2025 10:39:03 +0000</updated>
      <media:content url="https://www.pugpig.com/wp-content/uploads/main-media.png" width="1040px" type="image/jpeg"/>
      <media:description><![CDATA[This is a caption for the main media]]></media:description>
      <media:credit role="photographer">Frank Lockett</media:credit>
      <pp:template>article-layout-02</pp:template>
      <pp:analytics_sections>food</pp:analytics_sections>
      <pp:analytics_pubtime>10 AM</pp:analytics_pubtime>
      <pp:sponsor>
        <name>Microsoft</name>
        <logo>https://www.pugpig.com/sponsors/images/microsoft.png</logo>
      </pp:sponsor>
      <pp:comments comments="true"/>
    </item>

  </channel>
</rss>

Below is a downloadable feed which contains more examples including all the advanced inline element markup that Pugpig supports as well as examples of article audio, main media videos & galleries etc:
 

Download Full Example RSS Feed

Unsupported RSS Structure

Although we're quite flexible with how RSS feed data is constructed, the following examples are not supported with our systems and will prevent us from reliably mapping data:

❌ Nesting elements inside the <content:encoded> or <description> tags

❌  Mapping elements that contain certain text e.g mapping only categories containing a domain ending with channel: 

<category domain="http://pugpig.com/ns/rss/channel/">Residential</category>
<category domain="http://pugpig.com/ns/rss/industry/">Industrial</category>