The RebelMouse Site Migration Guide

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!

What Is RebelMouse?
Request a Proposal
subscription model for publishers
Rebel Insights

In 2023, Publishers Take Back Control With Subscription Success

Users are ready to pay for content that delivers

The Rise of the Mature User

It's been a long and winding path, but in 2023 the subscription model continues its upward trajectory as a top revenue strategy for publishers of all sizes. The tug of war between platforms and publishers reached its peak in the last few years of the previous decade, leaving users desperate for a modern user experience that's clear of any clutter from the duopoly that is Google and Facebook. This is why intelligent paywall models are a top choice for users looking to consume content right from the source. When done correctly, the strategy can work for any type of media. The New York Times, a frequent showpiece example of the power of paywalls, is constantly reporting record-busting subscription numbers, with 7.6 million digital subscriptions in 2021.

And it all makes perfect sense. The subscription model eliminates the middleman — such as the platforms — so readers get the experience and content they want, and publishers get the cash they need.

Keep reading...Show less
People on a train station
Rebel Insights

RebelMouse Q1 2021 Platform Updates

Speed, performance, and Core Web Vitals enhancements

Click here to read our Q2 2021 platform performance updates!

At RebelMouse, we pour our souls into making sure that our platform is always the most modern, high-performance CMS on the market. In fact, we invested over $100,000 worth of hours into our platform in Q1 2021 alone. This has resulted in updates and performance enhancements that publishers would have to pay for on their own to make happen on any other platform, such as WordPress. We're proud to be at a level of scale where we can invest this way into our platform, and we will continue to invest at this rate every quarter moving forward just as we have in the past.

Here are the major updates that we've added to the platform in Q1.

Keep reading...Show less
Interested in a Free Website Health Check?Check Your
Website's Health
Get Your Free Analysis Now