RSS Blocks In the Email Builder

Created by Stefan Perchinkov, Modified on Tue, 25 Feb at 6:29 AM by Stefan Perchinkov

The RSS Elements in the Email Builder allow you to automatically send emails containing dynamically inserted content when a new RSS (Real Simple Syndication) item is published. 

Usage

RSS Header

RSS Header Block

This will dynamically populate <channel> tags from your RSS Feed. The RSS Header Element supports the following RSS channel tags - use their respective Custom Value to populate the email with the corresponding tag value:

RSS Tags
Custom Value For HL
<title>
{{rss_feed.title}}
<description>
{{rss_feed.description}}
<link>
{{rss_feed.url}}
<lastBuildDate>
{{rss_feed.date}}

Basic Vs Custom in RSS Header 

When using the RSS Header block, you'll see two options in the "RSS Editing Options" dropdown selector: Basic and Custom.

Basic: adds the following non-editable text in Text Editor

  • <h1 class="h1">{{rss_feed.title}}</h1>    {{rss_feed.description}}<br />    <br />

Custom: adds the following editable text in Text Editor

  • Updates from {{rss_feed.url}}    <h1>{{rss_feed.title}}</h1>    <strong>{{rss_feed.description}}</strong><br />    <br />    <strong>In the {{rss_feed.date}} edition:</strong><br />

NOTE: The four custom RSS <channel> variables can also be used in the subject field like this:

RSS Items

RSS Items Block

The RSS Items block accepts the following Custom Values and will dynamically insert their corresponding RSS Tags:

RSS Tags
Custom Values
Description
<title/>
{{rss_item.title}}
The title of the RSS item is usually a blog post.
title

<description/>
{{rss_item.content}}
A summary of the RSS item in HTML format, which includes information inside the <description> tag. If there is no <description> tag in your feed, it will display the information in the <content:encoded> tag
<link/>
{{rss_item.url}}
The text link to the RSS item online, which can be displayed as text or used in a hyperlink.
content:encoded
<content:encoded/>
{{rss_item.content_full}
The full content of the information inside the <content:encoded> tag for an RSS item, in HTML format. If there is no <content:encoded> tag, it will display the information in the <description> tag.
pubDate
{{rss_item.date}}
The date the RSS item was published, in the format `MMM DD, YYYY hh:mm A`. We will provide support for custom formatting in the future.
<dc:creator>
{{rss_item.author}}
The author of the RSS item
media:content
<media:content>
{{rss_item.imageUrl }}
This will provide the src URL of the image as text to render it as an image, use {{rss_img}}


{{rss_img alt="alt_text" src=rss_item.imageUrl height="200" width="200"}}
<item>
{{#rss_items rss_items}}
This tag doesn't display anything. It's used to open the customized formatting for individual RSS items.
</item>
{{/rss_items}}
This tag doesn't display anything. It's used to close the customized formatting for individual RSS items.

Basic Vs Custom in RSS Items 

When using the RSS Items block, you'll see two options in the "RSS Editing Options" dropdown selector: Basic and Custom.

Basic: adds the following non-editable formatted text in Text Editor

  • {{#rss_items rss_items}}      <h2 class="mc-toc-title"><a href="{{rss_item.url}}" target="_blank">   {{rss_item.title}}      </a> </h2>      {{rss_item.content}}      <br />      <a href="{{rss_item.url}}" target="_blank">Read on »</a><br />      <br />     {{/rss_items}}

Custom: adds the following formatted text and the Text editor will become editable

  •  {{#rss_items rss_items}}    <h2 class="mc-toc-title"><a href="{{rss_item.url}}" target="_blank">{{rss_item.title}}</a></h2>    <em>By {{rss_item.author}} on {{rss_item.date}}</em><br />    {{rss_item.content_full}}<br />    <a href="{{rss_item.url}}" target="_blank">Read in browser &raquo;</a><br />    <br />    {{/rss_items}}<br />    <br />    <br />    <h3 class="h3">Recent Articles:</h3>   {{#rss_items rss_items}}

HTML-Based RSS Feed

The values returned by the RSS-based custom variable {{rss_item.title}} are HTML-escaped. For example, if the expression contains &, then the returned HTML-escaped output is generated as &amp; or if your RSS Feed has HTML-based text instead of plain text then it will be rendered as plain text.

If you don't want it to escape a value, use the "triple-slash", {{{:

Eg: if your RSS feed source is something like this

  • Without "triple-slash" it will render like this

once you will use "triple-slash" {{{rss_item.content}}} it will render like this

Scheduling:

To schedule RSS Feed based emails:

  • navigate to the "Send or Schedule" tab
  • select the "RSS Email Campaign" sending option
  • give your campaign a name in the "Campaign Name" field
  • paste your RSS feed URL in the "RSS Feed URL" field
  • Specify the maximum limit on the number of feed items to be processed per campaign.
    • This feature allows you to control the amount of content included, ensuring a more concise and targeted email for your recipients.

Scheduling Flexibility and Efficiency

RSS campaigns offer greater scheduling flexibility, real-time adjustments, and improved usability to better serve your email marketing needs. Users can schedule campaigns for the last day of the month, automatically adapting to varying month lengths. Additionally, dynamic helper guides simplify setup by providing contextual information, and same-day scheduling enables instant campaign execution when needed.

How to Use: 

  • Navigate to the RSS campaign settings. 
  • Choose your desired execution day (including the last day of the month or same-day scheduling), and let the dynamic helper guide streamline the process. 

Note: Execution days must be selected for proper scheduling.

Sending Options:

  • "When we should send": Here you can determine whether RSS Emails should go out Daily, Weekly, or Monthly as well as at what time the emails should go out.
  • Send on: Here you can choose the Day(s) of the week on which you want to send the campaign

Once all input fields are filled along with the recipient, in Review and Send side panel You will see the following new information

  • Email type
  • RSS Feed URL
  • Repeat After

Testing RSS Emails

When using the "Send Test Email" functionality with an email that has RSS Elements, you will see a new "RSS Feed URL" field where you'll need to provide the RSS Feed URL from where you want to pull the content. Without this, all RSS tag-based custom variables will be replaced by empty text.

NOTE: If you try to Schedule RSS Element-based email template through normal scheduling options (send now, schedule for later, send in drip mode), all RSS tags-based custom variables will be replaced by empty text.

View and Edit RSS Campaign:

You can see your scheduled RSS Campaigns in the Scheduled Tab, where you'll see the type listed as RSS. For other scheduled emails (send now, schedule for later, send in drip mode), the type will be Normal.

The example above is an RSS email set to send Daily and we can see the Next Execution time will be at 2 pm. Once the 2 pm email has been sent, it will be marked as complete and a new scheduling/execution will be scheduled with the same configuration (RSS Feed URL, send Daily) with the following day's date.

Actions:

With RSS-type scheduling, you can perform the following actions:

Edit: If you click the pencil icon to edit, you will see a confirmation modal asking you to confirm that you would like to cancel the currently scheduled email and re-schedule a new one.

  • Once you click Confirm, it will cancel the current scheduling and open up an Email Builder with RSS Scheduling options pre-filled with the current canceled scheduling information
  • Pause/Resume: You can also pause and resume the execution through the Pause/Resume actions
  • Delete: You can also delete the RSS scheduling. Deleting will first cancel the scheduling then delete it permanently from the system

FAQ’s

How can I use the RSS Elements in the Email Builder?
The RSS Elements in the Email Builder allow you to automatically send emails containing dynamically inserted content from an RSS feed when a new item is published. You can use RSS Header and RSS Items blocks to populate your emails with data from your RSS feed, such as titles, descriptions, dates, authors, and more.

What is the difference between Basic and Custom options in RSS Elements?
In the RSS Header and RSS Items blocks, the Basic option adds non-editable text to the email, using predefined RSS tags, while the Custom option allows you to edit the text in the email builder, offering greater flexibility to customize how the RSS content is displayed in your emails.

How do I schedule an RSS email campaign?
To schedule an RSS email campaign, go to the "Send or Schedule" tab in the Email Builder, select the "RSS Email Campaign" option, enter your campaign details, including the RSS Feed URL, and choose the frequency (Daily, Weekly, or Monthly) and the timing for the emails. Ensure all necessary fields are filled in, including recipients.

Why do my RSS-based custom variables show empty text in test emails or regular scheduling?
If you try to send a test email or schedule an RSS-based email through normal scheduling options (send now, schedule for later, send in drip mode), the RSS tag-based custom variables will be replaced by empty text because these options do not support dynamic RSS content. Use the "RSS Email Campaign" option instead.

What actions can I perform on scheduled RSS campaigns?
You can view your scheduled RSS campaigns in the Scheduled Tab. For RSS campaigns, you can edit the scheduling, pause/resume the execution, or delete the scheduling. Editing will cancel the current schedule and allow you to reconfigure it; pausing/resuming lets you manage the timing, and deleting will permanently remove the schedule.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article