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

Websites Are Built

The Fastest Sites in the World Run on RebelMouse

Let’s Chat


RebelMouse Performance Monitoring

Real-Time Core Web Vitals

Get Started

Our Core Features

Our platform is a complete digital publishing toolbox that's built for modern-day content creators, and includes game-changing features such as our:

Layout and Design toolLayout and Design tool on mobile

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.

upworthyindy100Vault12No Film SchoolRawStoryResponsible StatecraftPrideMNI Market NewsPremierGuitarPenskeINN Educate Brand ConnectThe FulcrumGZEROOkayafricaBrit+CoPaper MagazinePowerToFlyNarcityCommonDreamsAllBusiness

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.

Case Studies

A Team Built Like No Other

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.

Let's Chat