How do I use the new RSS block?

Letterhead allows you to add your RSS feed as a curations source, and it will pull those articles in to our Curations library (Stories and articles)

The new RSS block is perfect if you want to set up automations to pull certain articles from your feed based on specific criteria, as well as customize how they are displayed in your newsletter.  You will be able to filter by your source, which is the title of the RSS feed, published dates, or keywords.

To get started, review the steps outlined below.

To ensure uninterrupted access to our RSS feeds, please ensure that the following IPs are whitelisted and our crawler's domain is safelisted:

Whitelist IPs: 198.199.66.189 | 164.90.252.240

Safelist Domain: *.tryletterhead.com | letterhead.email | letterhead.ai

By whitelisting the above IPs and safelisting the mentioned domains, you enable our crawlers to efficiently access and retrieve content from our RSS feeds.

1. Navigate to Newsletters

2. Click on Curations

3. Click in the center on Sources

Click on Sources

4. Click on Add content

5. Add a title for your feed, a description and your RSS Feed URL

Add a title for your feed, a description and your RSS Feed URL

 

Note: If you are using an automation, we can set a dynamic title. We will loop through the whole newsletter to find the first heading (from h1 to h6). If there's any, it will be set as the dynamic title. Otherwise, we will loop through all RSS blocks (including new RSS blocks) to find the first title - it's a <strong> tag in your RSS (or new RSS) block content. When you use any layout that's not full content, the title is a <strong>.

How do we handle the super long title?

We will trim it to the last complete word and append ellipsis but the same time the whole character count is no more than 150 (including ellipsis).

6. The crawl feed option

'Crawl feed' will ignore the RSS feed and use the <link> within each item of the feed to go fetch the content from the site directly.  We recommend leaving this disabled, so Letterhead takes the tags inside the <item> node, instead of crawling the URLs inside each item.

In other words, if you enable 'Crawl feed', Letterhead will try to fetch content from the URL like in <media:content url="whateverLinkIs">, in the same way we pull from a URL, when you use our URL block. The caveat is that sometimes URLs allow us to crawl them, but sometimes they do not.

If you plan on adding a feed to use with the RSS block, it is best NOT to enable the 'Crawl feed' option. Letterhead will pull content from the feed every 15 minutes per feed. 

You can also choose to crawl your feed

7. Add your feed

8. Then navigate to your Newsletters

Then you will navigate to your Newsletters

9. Select the newsletter you are working on

10. Drag and drop RSS feed block

Drag and drop RSS feed block

11. Select your RSS feed source

Select your RSS feed source

12. Select all days or use exact dates

Select all days or use exact dates

13. Select how many items to show in feed and/or how many items to skip

Select how many items to show in feed and/or how many items to skip

14. Load your feed

 

If your curation shows up twice, this may be why...

The following are the same:

  • <title>
  • <link>
  • <pubDate> is same day of an otherwise identical item
  1. If the same item is included in a different feed, then it will be inserted separately.
  2. If anything about the title or link are different -- such as, in one case, the casing of the title was different ("The" instead of "the"), or it's a totally new date, or the url has changed, Letterhead will see this is a separate entry.

15. Select from various layout-options

Select from various layout-options

16. Select your RSS display options

Select your RSS display options

17. Adjust your column width

Adjust your column width

18. Adjust your images

Adjust your images

19. Customize your RSS look and feel

Customize your RSS look and feel

 


Created with Tango.us