Importer Tool: Importing Listicles

Laura Barros
Tue, 17 Oct 2023 17:14:37 +0000
Site growth, Website, Cms, Content import, Social cms, Best cms, Best cms 2020, Site design

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:

Any text that exists before the code 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:

{ "headline": "This is an awesome post!", "body": "
foo

bar
", "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 } } }