How to...

Use Bibblio’s catalogues to separate your content

Group tactics

When deciding on catalogue creation, it's best to think not only of the existing categories in your collection, but also their grouping for the purposes of recommendation. 

For example, a news site layout might separate content between categories, such as business, politics, culture, entertainment, and opinion. The recommender engine automatically takes care of finding business-related suggestions for business articles and so on, therefore using catalogues to separate topics is not necessary.

However, if the opinion articles tend to drive a lot of traffic and your site triggers a subscription wall after a four article limit, it might be useful to move the opinion pieces to a separate catalogue and showcase them in their own widget in order to ensure your users hit that limit faster.

The journey to the subscription paywall via recommendations

You can also use catalogues to distinguish between different content formats, such as driving more traffic to your webinars, industry reports or embedded video.

The catalogue functionality is only available with the Quick Start code or via the API.

How to import your content into separate catalogues with the Quick Start code

  1. Go to the Quick Start code generator.

  2. Complete each step. When you reach step 4a, copy and paste that snippet into your template.

  3. Within the script tag, add the property


    replacing YOUR_CATALOGUE_NAME with a unique name of your choosing.

  4. Save your template.

You can then create a new snippet with a different catalogue name for another template.

If you’re using the same template for different types of content, you can use conditional statements to load the snippets.

For example, in a PHP template that displays either sponsored or editorial content:

<?php if($post_data->Sponsored_Content == "y"){ ?>
    <script id="bib--rcm-src"
</script> <?php } else { ?> <script id="bib--rcm-src"
</script> <?php }; ?>

How to add catalogues via the API

When creating a content item via the /content-items endpoint you can add customCatalogueId to the payload in order to specify where the content item should be stored:

  "name": "Air Pollution",
  "text": "Air pollution consists of chemicals or particles in the air that
can harm the health of humans, animals, and plants. It also
damages buildings. Pollutants in the air take many forms. They
can be gases, solid particles, or liquid droplets. Sources of
Air Pollution Pollution enters the Earth's atmosphere in many
different ways. Most air pollution is created by people, taking
the form of emissions from factories, cars, planes, or aerosol
cans. [...]", "url": "", "customCatalogueId”: “Editorial Content” }

How to display recommendations from another catalogue

A page that has been imported to a catalogue will by default only show recommendations from that same catalogue. You can choose to display recommendations from another catalogue by adding a property to the script displaying the recommendations.


Quick Start code

  1. Go to the Quick Start code generator.

  2. Complete each step. When you reach step 4b, copy and paste that snippet into your template.

  3. Within the div tag, add the property

    data-custom-catalogue-ids=”sponsored-content, editorial-content”

    where each value is a catalogue name, separated by a comma.

  4. Save your template.



To display recommendations from another catalogue, specify the catalogue id when making a GET request to the /recommendations endpoint:

Catalogues in action


Sponsored content

Live Design, the creative and technical resource for live entertainment professionals, uses a second module to promote their sponsored content from a separate catalogue.

Currently enjoyed by

Live Design

Related content module on Live Design

Related guides

Need further assistance?

Visit the Help Center or get in touch with the Bibblio team.