The RebelMouse Site Migration Guide

An overview of our straightforward migration process

RebelMouse's Importer tool (available via GitHub) was built to make importing your content into RebelMouse simple, fast, and accurate.

To help you get up and running on RebelMouse quickly, we've taken steps to automate as much of the migration process as possible.


This guide covers the process's three basic steps:

  1. Setting up Your Environment
  2. Preparing Your Data
  3. The Migration Process

Your Environment

Create Your Environment

You will first need a docker application on your local machine. Once this has been set up, you will need to download the RebelMouse Importer.

These are the only steps necessary to prepare your import environment.

Configure Your Environment

Once you've created your environment, you will need to configure it in order to start using the API.

We've made this configuration as simple as possible by placing a folder named with already-specified variables in a root folder of the RebelMouse Importer.

You will need to know your:

  1. Domain
  2. API token
  3. Basic authorization (e.g., username, password)

Prepare Your Data

Review Our Example

RebelMouse has API documentation and guides that you should get acquainted with first, but we know that the most helpful thing for any developer is ultimately a working example. For this reason, we've provided a WordPress example for you to review.

In the docker container, you will see three main elements:

  1. A data dump
  2. Data storage to keep processed data (MongoDB) between operations
  3. Scripts that use our public API and explain all the migration steps

Set up in XML

Following the WordPress example provided (altering it as needed for your specific application), set up your data in an XML format.

Once it's ready, you can simply copy and paste.

Migration Process


To start, we have to import four kinds of objects:

  1. Media assets
  2. Sections
  3. Authors
  4. Posts

The easiest way to ensure that this is done correctly is to start from scratch. To do this, you'll want to start from an empty RebelMouse site (Runner) that doesn't contain any existing posts or sections.

Migration Steps

  1. Upload the Dump: The dump file is already in place since it's already been used for testing multiple times.
  2. Parse the Dump: Depending on your specific use case, the whole import process might be as simple as running one script. However, for demoing purposes, let's go through it step by step.
    1. Dump Parsing Process (~30 seconds)
      1. The first step is the dump parsing process. This will extract all of the needed data from the source file and store it in MongoDB. It will also get rid of all of the unnecessary data so it's easier to analyze the content. This process only needs to be performed once, which speeds up additional import attempts when needed.
  3. Import Images: Next, we'll begin the import process for images.
  4. Import Sections: Now it's time for sections.
    1. At this point in time, we can only handle standard sections. Support for nested sections was added to our API recently, and will be added to the Importer's functionality soon.
  5. Import Authors: Next up is the creation of authors. There's nothing special behind this process, as it's very similar to the process that we use for all WordPress imports.
  6. Import Posts: At this point, all media, sections, and authors have been imported. Now we can import posts.
  7. Check for Errors: Different kinds of errors may occur during the import process. We save and log them all so a developer can go back and debug and/or fix them.
    1. There may be serious issues that will require closer attention.
    2. There may also be insignificant errors that can (and should) be ignored.
      1. For example, something that should be ignored is a completely broken post draft that can't be imported. It should not be imported as there is no need to migrate bad data to your new site.
  8. Import Completed: Check the results to be sure that everything looks as expected.

If you have any questions about this process, email or talk to your account manager. If you're running into an issue or error, please be sure to include screenshots and details about the nature of the problem so we can better assist you.

Good luck!

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

Nordot + RebelMouse

RebelMouse and Nordot have joined together to provide publishers access to Nordot's massive content library directly from the RebelMouse CMS.

Keep reading... Show less

Facebook Instant Articles: Troubleshooting, Debugging, and Tokens

Facebook Instant Articles are a great Facebook feature, but sometimes there can be issues that need to be addressed. In this post, we'll be looking at a few of the most common, including:

  • Resolving Facebook Instant Articles errors
  • Resolving Facebook expired token notifications
  • Resolving any setup issue regarding Facebook Instant Articles
Keep reading... Show less

SEO Decline? Google Featured Snippets Are Dramatically Reduced

You may have noticed a decline in your traffic recently, particularly from Google Search. It appears that Google has changed their algorithm to dramatically reduce the amount of featured snippets that are showing on the search engine's results page. If you consistently get traffic from featured snippets, this algo update will most likely have a negative impact on your search traffic.

Keep reading... Show less

Bot Traffic Filtering With RebelMouse

Bot traffic is essentially any traffic that comes to a website that is not an actual human visiting the site. Bot traffic can be either beneficial or malicious. For malicious bot traffic, you may want to consider blocking it. For many publishers, the free tools in Google Analytics may be enough, but we also offer a more comprehensive option.

Keep reading... Show less
Subscribe to Our Newsletter