RebelMouse Talk to Us
How to Schedule and Configure Newsletters on RebelMouse

How to Schedule and Configure Newsletters on RebelMouse

Email campaigns are a great way to interact with your most engaged audiences, which is why we've created an intuitive way to send emails right from our Entry Editor. RebelMouse has robust newsletter integrations that allow you to easily send out a post as a newsletter, as well as set up daily and weekly recurring emails directly from the platform.

Here are two step-by-step guides on how to schedule newsletters on RebelMouse.


Send out a Post as a Newsletter

First, to enable the feature, your site must have the extra Enable Newsletter Tab in Entry Editor set to True.

Once that's enabled, the Send Post as Newsletter option becomes available within the Send a Newsletter tab in Entry Editor.

Sites using a default RebelMouse template will send the post's complete HTML to an external provider, while those using custom templates will send a list of variables to the external provider. Review the next section to see a complete list of available variables.

Sender classes are smart enough to detect if a campaign already exists on a server to choose if we should add to or update a campaign.

Template Variables

Variable Name

Description

post_url

The post's URL.

E.g., http://www.rebelmouse.com/my-post-1.html

bookmark_url

The URL that's used to save a post to read it later. This is the post_url with the "?with_save=1" parameter appended.

E.g., http://www.rebelmouse.com/my-post-1.html?with_save=1

post_id

The post's ID.

roar_id

The site's ID.

authors_names

A list of strings containing author names. The order of their appearance is the same as what has been defined in Entry Editor.

Mailchimp Integration: See the special notes section below.

authors

A list of dicts with all attributes related to the post's author. The order of their appearance is the same as what has been defined in Entry Editor. Available fields are detailed in the following table.

created_date

This is the post's created date using the format: MMM DD.

E.g., Jan 01

list_name

The destination list's name.

header

The post's headline.

subheader

The post's subheader.

newsletter_alert_text

The alert text in the "Send a Newsletter" tab in Entry Editor.

before_listicle

The text that comes before the listicle items list.

listicle_items_list

A list of listicle items in the post, including all attributes available in our database. Available fields are detailed later in this guide.

Mailchimp Integration: See the special notes section below.

related_posts_list

A list of related posts items in the post, including all attributes available in our database. Available fields are detailed later in this guide under the "listicle_items_list" section.

after_listicle

The text that comes after the listicle items list.

imageXXXX

The lead image of the post in different resolutions. Instead of XXXX, use the proper resolution. Common resolutions are: 35x35, 210x, 300x, 600x, 980x, and original.

Mailchimp Integration: See the special notes section below.

"Authors" Dict Details

Variable Name

Description

id

site.id

site_id

site.id (for backwards compatibility; use this only when necessary)

owner_id

site.owner_id

name

site.name (uses underscores instead of spaces)

title

site.title (has spaces between words)

avatar

site.display_logo

about_html

site.about_html

description

site.description

"listicle_items_list" Details

Variable Name

Description

id

A listicile item's sequential ID.

index

A listicle item's index.

basename

A slugified version of a listicle item's headline (spaces are replaced with hyphens "-").

is_first

This is only added to the first item of a listicle list to indicate that it's the first item.

is_last

This is only added to the last item of a listicle list to indicate that it's the last item.

headline

A listicle item's headline.

item_permalink

This is the post_url with the parameter "?rebelltitem={listicle_id}" appended.

is_image

This indicates if the listicle item contains an image.

item_anchor

This is the anchor that's appended to the end of the post_url that allows you to navigate directly to the listicle item.

E.g., #rebelltitem1

body

The HTML of the listicle item's body, which contains shortcodes that can only be processed on RebelMouse.

Important: This should not be used in email templates. Use the "description" variable instead.

description

The HTML of the listicle item's body, which replaces shortcodes that can only be processed on RebelMouse with proper HTML tags.

image_id

The image_id used in the listicle item.

item_bookmark_url

The URL that's used to save a listicle item to read it later. This is the post_url with the "?with_save=1#rebelltitem{listicle_item.id}" parameter appended.

media_html_desktop

The HTML code that's used for desktop sites with a listicle item that has lead media.

media_html_mobile

The HTML code that's used for mobile sites with a listicle item that has lead media.

thumbnails

This is the dictionary containing different sizes of any media.

post_id

This is the post's ID.

imageXXXX

The lead image of the listicle item in different resolutions. Instead of XXXX, use the proper resolution. Common resolutions are: 35x35, 210x, 300x, 600x, 980x, and original.

Mailchimp Integration: See the special notes section below.

Mailchimp Integration: Special Notes

Repeatable Content

Mailchimp allows you to add repeatable content to your templates by adding the attribute mc:repeatable to an HTML tag. For example:

<div mc:repeatable="listicle_items" />

We also give meaningful names to blocks, but they're not accepted by Mailchimp. When we send data to their API, we must send repeatable data in a specific order.

We send two repeatable blocks to templates:

  • authors_names, which is rendered as "repeat_1"
  • listicle_items_list, which is rendered as "repeat_2"

Even if we don't want to show author names in a template, they must be declared before the listicle items list — otherwise, the listicle will not display correctly.

Names of Authors

To use author_names in Mailchimp, we need to use both the repeatable content and author names attributes. For example:

<div class="author_names" mc:repeatable="author_names">
 <p mc:edit="author_name">Author Name</p>
</div>

Editable Image Areas

Mailchimp uses the mc:edit attribute, which can be added to many HTML tags, to indicate that the content will be dynamically updated. The <img> tag allows it, but it indicates that users can only change the image from Mailchimp's Editor. The API can't modify this attribute.

As a workaround, when we need to display an image, we need to add in <div mc:edit="my_image_variable">. And instead of using an imageXXXX attribute, we must use html_imageXXXX, which will be rendered including the <img> tag.

For example, if the image2000x value is: https://assets.rbl.ms/9904159/2000x.png.

Then the html_image2000x will be:

<img src="https://assets.rbl.ms/9904159/2000x.png" />

Mailchimp API Not Replacing Content Sections

When using the mc:edit attribute, you may run into issues with Mailchimp's WYSIWYG editor not pulling in your content. For example:

<div mc:edit="rm_posts"></div>

This is a known issue that's solved by exporting your template from Mailchimp, adding the mc:edit attribute to your code, and then uploading it as a custom template.

Daily + Weekly Newsletters

You can set up recurring newsletters right from within RebelMouse. Here's a step-by-step guide of how to set up the feature correctly.

The site will be processed only if one of the newsletter options is enabled in your Dashboard:

Daily newsletters are enabled by selecting the option "Send a daily newsletter to my subscribers."

Weekly newsletters are enabled by selecting the option "Create campaign with my most popular content from the week."

Sender classes are smart enough to detect if a campaign already exists on the server to choose if we should add or update the campaign.

Logic to retrieve posts for a newsletter:

  1. Get the MAX_POSTS_LIST_SIZE (default variable value is 20) recent posts.
  2. Filter out the posts added only to private sections.
  3. Split posts into two groups: popular (those manually added to the /popular section) and not-popular.
  4. Only get the MAX_POSTS_ADDED (default variable value is 7) posts from the popular group. If we don't have enough posts, then get the remaining posts from the not-popular group.

Template Variables

When a site uses a default RebelMouse template, the newsletter's HTML content will be generated in our platform and sent out to the provider.

However, when a site uses a custom template, we need to send out variables that you can then use in a template:

Variable Name

Description

rm_site_title_avatar

This displays the site's logo and name.

E.g., http://jmp.sh/TKjLXT5

rm_social_networks_without_avatar

This displays a bar that enables newsletter recipients to share your site on Facebook, Twitter, or through email.

E.g., http://jmp.sh/AbaKAeZ

rm_social_networks

This displays a combination of rm_site_title_avatar and rm_social_networks_without_avatar.

E.g., http://jmp.sh/D1SSGv6

rm_posts

This is HTML containing a full list of posts, including the lead image, a post brief, and the "Keep reading..." option.

E.g., http://jmp.sh/TcTn1gm

posts_list

This is a list of posts with a lot of independent variables to give users the flexibility to customize their templates. Each post is an element of the list. Each post also has the same variables described above in the "Send out a Post as a Newsletter" section.

Samples:

rm_site_title_avatar

rm_social_networks_without_avatar

rm_social_networks

rm_posts

If you have any questions about scheduling and sending out newsletters, please email support@rebelmouse.com.

Related Articles:

Tour the Newsletter Dashboard

Overview: RebelMouse + Mailchimp Integration

New Feature Alert: Mailchimp Groups Integration

NEW! Newsletter Integration with WhatCounts

Why RebelMouse Is the Best Content Marketing Platform

RebelMouse is a unique platform and company. The company was founded on the vision that media companies would need an always-modern solution to thrive in the new connected internet, and that brands would have to behave like new media companies and use the same platforms.

Keep reading... Show less

Why Premium Creative Agencies and CTOs Choose to Develop on RebelMouse vs. WordPress and Drupal

The Intersection of Design and Development: Where Your Clients Thrive

We started RebelMouse seven years ago knowing that there was a fundamental design flaw in the world of traditional CMSs: Every instance, on every platform, had to be updated independently. It's similar to an era when users had to manage their own Microsoft Exchange Server for email. The costs of managing, maintaining, and iterating on a CMS to keep it awesome and world class is typically a $10 million-a-year endeavor. But even then, these cost-prohibitive CMSs are still behind the times.

Keep reading... Show less

Native Multivariate Testing at Scale With RebelMouse

What Differentiates Our Approach

There are many popular tools that allow you to perform experiments and A/B tests on your users — primarily Google Chrome Experiments and Optimizely. But all of these solutions are JavaScript additions to your web page that sidestep the problem of old, outdated, and clumsy CMSs. These solutions work by calling on a third-party JavaScript library that rewrites a page after it's rendered. This approach adds extra page weight and creates strange user experiences due to having to wait for everything to load and be rewritten on the fly.

At RebelMouse, we've solved this in a very elegant way. At the core level of our platform, we can natively render different layouts and track the exact differences in performance when comparing a test to your other layouts.

Keep reading... Show less

Modern E-Commerce: Blur the Line Between Content and Design

Create Modular + Reusable Design Patterns on RebelMouse

Content saturation is an industry-wide problem, and the e-commerce space is no exception given that it's filled with big brands, small Etsy stores, and everyone in between all fighting for similar audiences. The best way to fight this symptom is to understand your audience and provide them with what they want.

Keep reading... Show less

Instagram-style E-commerce Features on RebelMouse

Revolutionizing e-commerce on RebelMouse

Whether you're a brand with a blog or a media company with a site, driving purchasing behavior and building an audience that uses your content to find things they love to buy is vital. We're very proud to have built out the same functionality that everyone is now used to on Instagram, with layovers on images that lead to products with attribution.

Keep reading... Show less

Building Premium Communities and User Journeys on RebelMouse

RebelMouse is much more than just a replacement for a traditional CMS. Our platform is a tremendous community-building experience. Today's social ecosystem has given us a seemingly limitless number of premium creators who understand how to create gorgeous and relevant content that drives the growth of their own audiences. These creators and influencers are either experts in certain topics, or heavily engaged in targeted content that drives their interests. They're not only consuming the content they're passionate about, but they're contributing to the conversation, too. The new role of the editor is not just to cover the most important topics and people around their expertise, but also to invite those preferred influencers into their community and get them to participate in creating premium content.

Keep reading... Show less

Dynamic Voting: Grow Traffic and Engagement Organically

Help your audience find its voice.

Creating quality content is no longer on marketers alone. We live in a universe of creators who are willing to not only consume content that resonates, but play a role in the creation, promotion, and conversations surrounding it.

Since the start of RebelMouse, we've been on a journey to create dynamic media that is easier for content creators to curate and amplify on social. It's why we've built an online engagement platform centered around the power of communities that thrive naturally in the digital ecosystem.

Keep reading... Show less

How to Monetize Your Website in Today’s Publishing Environment

In order to define distributive publishing, we have to ask the following question: If you have quality content, but nobody sees it, does it even exist? The answer is no, because your content needs to be supported in a way that lets it move seamlessly across all channels, especially site, search, and social. But let's take this question a step further: If you can't monetize your content to generate the support it needs, how do you create quality content in the first place?

Keep reading... Show less

RebelMouse Q3 2021 Platform Performance Updates

For many publishers and brands, Q3 2021 was about recovering web traffic lost to Google's page experience signals update that was rolled out over the summer. For us, the quarter was about continuing our success of delivering excellent Core Web Vitals metrics across our site network with platform performance updates both big and small.

As a globally distributed team, it's important for us to remain transparent about how we're able to power some of the best-performing sites on the open web. And while we're already looking forward to closing out the year stronger than ever before, here's a detailed look back at our accomplishments in Q3 2021.

We invested 1,946 hours into our platform in Q3 2021 alone, and all of the sites on our platform benefited from the work in various ways. Here are the key areas that we focused on:

  • 184 hours were spent on delivering new features
  • 1,010 hours were spent on improving existing features
  • 752 hours were spent on performance and infrastructure updates
Keep reading... Show less

RebelMouse Clients See Performance Improvement After AMP Optimization

Performance is a major pillar of our platform, which means we are always making changes — both big and small — to improve page speed. Our focus on fast websites isn't platform specific, either. We want to make sure that users have a top-notch experience however they view your content, and this includes our integration with Google's AMP format.

Our team of traffic-obsessed developers recently implemented some performance optimizations to enhance our platform's integration with AMP, and that has improved the average response time for our clients. This means that users are able to access your AMP pages more quickly, which, in turn, improves your site's traffic from Google.

Here's a breakdown of the changes we've made:

Keep reading... Show less

Keep Search a Priority With SEO-Friendly Image Filenames

There are a lot of factors that go into a successful search engine optimization (SEO) strategy, including performance, structured data, and, of course, choosing the right keyword(s). Our proprietary search technology helps content creators prep every article for success on search. This all-encompassing approach includes the use of SEO-friendly image filenames.

On RebelMouse, if you assign an alt tag to an image in Entry Editor, that alt tag will also become the image's file name. Briefly, alt tags describe images for search engines, and also allow people using screen readers to know what the image is without actually being able to see it. Adding your desired search phase to every alt text field, and in turn every image file name, will reinforce its relevance to Google's crawler, bringing you one step closer to the top of search returns.

Keep reading... Show less
Subscribe to Our Newsletter