Importer Tool: Importing Listicles

RebelMouse importer tool guide to import listicles as a part of posts

Listicles add another layer of complexity when it comes to importing content.

To get the most out of this article, please make sure you've already read both the Setting Up Your Import Files and the Import Images, Users, Sections, and Posts articles. Those will help you better understand the content below.
Listicles are a collection of particles that can be injected into the body of a post. To ensure that your listicles display correctly in a post body on RebelMouse, you must follow these steps:

1. Prepare the Images

Before importing listicles, you must ensure that all of the necessary images are imported into RebelMouse. This is a mandatory step, since listicles will reference these images using the image_url field, which is unique to RebelMouse's importer tool.

2. Insert a Listicle tag in Your Body Field

In your post's body field, you need to insert the following tags to indicate where the listicle will be displayed within a post:

  • <listicle></listicle>

Any text that exists before the <listicle>code</listicle> opening tag will be considered a part of the body content, and any text after the closing tag will also be treated as part of the body content.

3. Define the Listicle Content

The normal schema of a listicle follows our API documentation located here.

But please note that when importing listicles, you should use the original image_url instead of the media shortcode or image_id. This is because, at the moment of import, it's very unlikely that you will have access to the shortcode or image identifiers. To ensure that your listicle images are referenced correctly within RebelMouse, always use the image_url provided.

This is an example of a post JSON object that contains listicles inserted into the post body:

<code>{ "headline": "This is an awesome post!", "body": "<p>foo</p><listicle></listicle><p>bar</p>", "listicle": { "items": [ { "headline": "Listicle 1", "body": "Here is some content", "image_url": "URL_of_the_referenced_image" } ], "settings": { "body_text_above": true, "layout_type": 1 } } }
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