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, along with template variables.
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 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 RebelMouse should add to or update a campaign.
Template Variables
Variable Name
Description
post_url
The post's URL.
E.g.,
https://www.example.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.
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 "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 listicle 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:
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.
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 and 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 RebelMouse should add or update the campaign.
Logic to Retrieve Posts for a Newsletter
Get the MAX_POSTS_LIST_SIZE (default variable value is 20) recent posts.
Filter out the posts added only to private sections.
Split posts into two groups: popular (those manually added to the /popular section) and not popular.
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.
rm_social_networks_without_avatar
This displays a bar that enables newsletter recipients to share your site on Facebook, Twitter, or through email.
rm_social_networks
This displays a combination of rm_site_title_avatar and rm_social_networks_without_avatar.
rm_posts
This is HTML containing a full list of posts, including the lead image, a post brief, and the "Keep reading..." option.
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.
If you have any questions about scheduling and sending out newsletters, please email
support@rebelmouse.com.
Our platform is a complete digital publishing toolbox that's built for modern-day content creators, and includes game-changing features such as our:
Why RebelMouse?
Unprecedented Scale
RebelMouse sites reach more than 120M people a month, with an always-modern solution that combines cutting-edge technology with decades of media savvy. And due to our massive scale, 1 in 3 Americans have visited a website powered by RebelMouse.
120M+ Users
550M+ Pageviews
17+ Avg. Minutes per User
6+ Avg. Pages per User
Today's Top Websites Use RebelMouse
Thanks to the tremendous scale of our network, we are able to analyze a wealth of traffic data that informs our strategies and allows us to be a true strategic partner instead of just a vendor.
What Clients Say
We’re here to help you weigh and understand every tech and strategic decision that affects
your digital presence. Spend less time managing everything yourself, and more time focused on
creating the quality content your users deserve.
From start to finish,
RebelMouse blasted away our expectations!
Kelley Beaucar Vlahos
Editorial Director
Responsible Statecraft
RebelMouse
brings the strengths of a large publisher (large datasets, expertise, lessons learned from trial and error, close
relationships with search and ad platforms) to smaller publishers. During the build and launch, the team went above
and beyond to ensure we were happy with the new site, and
they flawlessly migrated over 20,000 articles. I can't recommend them highly enough.
Ryan Koo
CEO
No Film School
I love the control panel. Awesome work. I have to say, what an amazing creative team RebelMouse is. I am so grateful!
Terrence O'Hanlon
Founder and Chairman
Reliabilityweb
It’s like we’ve been riding horses to commute all our lives and someone just showed us a Tesla.
Brendan Farley
Vice President, Product Management
Strada Education Network
Thanks to RebelMouse, United doesn’t have to sacrifice great content for speed. You can have both!
Ryan Bujeker
Director, Social Media Strategy & Digital Engagement
United Airlines
We're in a much better position to make it through the current crisis in part due to RebelMouse and their platform.
We've not only saved on overhead costs, we've more easily optimized our traffic with their smart measuring and SEO
tools, as well as their social integrations.
Jill Braff
President/Chief Operating Officer
Brit + Co
THANK YOU for all the good, fast work you put into making our public rollout such a big success. I know we threw a lot
at you very quickly, but you were calm under pressure and pulled it all off perfectly. Very glad to be working with
you all.
Tim Grieve
Executive Editor
Protocol
So inspired and impressed by these results from RebelMouse. Check them out and ask Andrea Breanna how they got there!
Just goes to show that spending millions doesn't necessarily get you to the right destination. It's spending no more
than you need on the right technology with the right platform that does! 🌐💙🏎️
Andrey Lipattsev
Partner Development Manager
Google
It is not often I jump out of my chair and scream in a positive way, but I just did! This is the happiest I have seen
my Managing Editor in 2021! Thank you.
Nick Smith
CEO
Investing News Network
Working with RebelMouse is an actual treat. From the CEO down, every single member of the team has partnered with us
to meet our needs. Everyone willingly (and with endless patience!) shares their expertise and insights to ensure we
optimize search and create a great audience experience. As we have implemented the various search tactics, positive
results are almost instantaneous. Training our content creators has been simple. The system is incredibly user
friendly. As a co-worker commented, "RebelMouse doesn't just sell you something, they partner with you to deliver
exactly what you want." I couldn't agree more!
Emma Schofield
Director of Change Management
Investing News Network
We continue to be huge fans of RebelMouse and envision a very long-term relationship with the platform. The service
has been impeccable.
Douglas Fischer
Executive Director
Environmental Health News
I am a HUGE RebelMouse fan, and basically tell everyone I meet who's looking to overhaul their website to get in touch
right away.
Susan Hassler
Editor Emeritus
IEEE Spectrum
Every member of the RebelMouse team, but especially our project team, are superstars! Our site launch on the platform
met all our expectations and we love the technology. We are positive about the future of our site and look forward to
improving our approaches and processes with RebelMouse's guidance!
Terrence O'Hanlon
Founder and Chairman
Reliabilityweb
RebelMouse's Layout & Design Tool is one of the most comprehensive and flexible tools I have ever used of any CMS.
Their product team is also extremely helpful and constantly supports to make sure your properties are up to date and
use the best industry standards, especially in terms of page speed.
Chuck Lapointe
CEO
Narcity Media
The best thing about RebelMouse is how much they care about their customers. When working with them, I always get a
sense that they go above and beyond for their customers. When working with the RebelMouse team, I very much consider
them to be a partner, rather than just a vendor. Upon migrating to their technology, we have seen tremendous
improvements in many key areas, particularly technical SEO. They have out-of-the-box functionality that is
tremendously helpful to customers. At the same time, their system is flexible enough to allow us to adapt it to any
new business needs that we have.
David Nguyen
Senior Director of Digital Marketing
Investing News Network
RebelMouse has shepherded us through the modernization phase, and has been keen, practical, and nimble throughout the
entire journey. They have helped modernize our website through an infinite scroll setup that allows us more
advertising real estate while creating more time on site to capture reader engagement. Plus, the RebelMouse team has
helped educate our own team on the various aspects of programmatic advertising and worked to best implement them.
Premier Guitar joining forces with RebelMouse in 2020 was one of the best choices we could have made!
Luke Viertel
Digital Strategist
Premier Guitar
RebelMouse has stepped up our content management process by providing a user-friendly interface, robust customization
options, and seamless collaboration tools. The platform's analytics and reporting capabilities have empowered us to
make data-driven decisions, while their exceptional customer support ensures any issues are promptly addressed in a
professional, respectful, and friendly way!
RebelMouse employs a unique, diverse, and decentralized team that consists of 70+ digital traffic experts across more
than 25 different countries. We have no central office, and we cover every time zone to ensure that we’re able
to deliver amazing results and enterprise-grade support around the clock.
Our team is well-versed in all things product, content, traffic, and revenue, and we strategically deploy ourselves to
help with each element across all of our clients. We thrive on solving the complex.