Creating Content
      Back to home
      1. Letterhead Help Center
      2. Newsletters
      3. Creating Content

      Ensuring Your Images Appear in the RSS Composer Block

      Why Aren't Images Appearing in the RSS Block? When you use an RSS feed as a content source in Letterhead, images should be automatically pulled from the or node within . However, if images are missing in your curate

      Why Aren't Images Appearing in the RSS Block?

      When you use an RSS feed as a content source in Letterhead, images should be automatically pulled from the <media:content> or <enclosure> node within <item>. However, if images are missing in your curated articles and the RSS block it is likely due to issue(s) with the feed structuring.

      Common Causes

      • Images embedded incorrectly: If images are inside <description> or <content:encoded> using an <img> tag within a CDATA section, they are treated as plain text rather than structured XML.

      • Missing image nodes: If <media:content> or <enclosure> nodes are absent inside <item>, no images will be extracted.

      • Unsupported image nodes: The RSS block does not support <media:thumbnail>.

      How Letterhead Reads RSS Feed Images

      Letterhead pulls images from the <media:content> or <enclosure> node inside <item>. If your feed does not use these nodes correctly, images will not appear in the RSS block. For more details on <media:content>, see the Media RSS Specification.

      Special Notes on Image URL Formatting

      To ensure your images are recognized and displayed correctly, follow these guidelines:

      Avoid CDATA Wrapping

      Image URLs should not be enclosed within a CDATA section.This causes the URL to be treated as plain text

      Use Simple URLs
      • Ensure URLs follow a basic format, such as: 
        <media:content url="https://website.com/image.jpg"/>
      • Avoid special characters like #, ;, and unnecessary query strings.
      • Use common image file extensions (.jpg, .jpeg, .png).

      Note: According to the RSS 2.0 specification, <image> is a sub-element reserved for <channel> (metadata about the entire feed). It cannot be embedded within <item> (metadata for an individual post or article).

      Best Practices for RSS Feed Structuring

      To ensure compatibility with Letterhead:

      1. Validate your feed using an open-source tool like W3C Feed Validator.
      2. Follow the RSS 2.0 specification to structure your feed correctly.

      What If My Feed Can't Display Images?

      If your feed is not following the structures and syntax defined above, images may not appear in the RSS block. While you work on improving your feed to meet the recommended standards, you can still display the following in the RSS block:

      • Title
      • Excerpt
      • Date Published
      • Source
      • Author