Quick Start Guide

Get going with Bibblio's auto-ingestion wizard

My Checklist

Before you proceed with setup, make sure each of these are true:
  • My site is not password protected
  • I’m using canonical tags
  • I have more than five content items
  • I have access to my content template, or use a plugin that easily inserts PHP code snippets

Getting Started

Create a Bibblio account. You can pick a free plan for testing or one that suits your catalogue size and traffic.

Once you’ve verified your account via the email we sent you, and logged in, you’ll see our Quick Start code generator.

STEP 1

Check your whitelist

Check the correct domain has been whitelisted. Add more by clicking “Set a domain to whitelist”. This should all be in lowercase, and include subdomains like blog.mydomain, as well as your staging environments.

STEP 2

Choose your module design

Go for the default row of three tiles, or click “Change layout” to alter the configuration, image ratio and any effects you’d like. You can always make further adjustments later.

TIPS

Going for a side widget? We definitely recommend a column, since rows will get squished in a sidebar.

Want the module to match your theme? You can take it to the next level by overriding our css within your own stylesheet.

STEP 3

Add tracking parameters (optional)

Using Google Analytics? You can add utm parameters to the code snippet to track us on your analytics platform. Click Create new tracking parameter. Add a name for the parameter and its value, then click Add to snippet. A line in your snippet will look similar to this: 

data-query-string-params="PARAMETER_NAME=PARAMETER_VALUE"

Repeat this process for each parameter you would like added. 

Separate your content (optional)

Is your site multilingual? Do you have a products section that you wouldn’t want appearing in your articles’ recommendations? You can use our catalogue function to separate content into folders, or “catalogues”.

data-auto-ingestion-custom-catalogue-id="YOUR_CATALOGUE_NAME"

Copy and paste the snippet with the catalogue name you chose in the appropriate template. You can then create a new snippet, add a different catalogue name to it and place it in another template.

If you’re using the same template for these different types of content, your catalogue’s name should be a value we can extract from the page when it loads, for example using PHP.

Hide Bibblio during the installation 

If you have 10,000+ items to import, you may want to hide the module during installation, as it may take more than 5-10 minutes for recommendations to appear. You can add the following property to the snippet:

data-hidden=true

Don’t forget to remove it once you can see recommendations appear in the “Content” section of your Bibblio account.

Choose a recency setting

If your site has lots of content but only the most recent stuff is likely to be relevant to your audience (such as a news site), you can prioritize recency so that content published within a chosen period is more likely to appear as recommendations. (Older content may still appear, but only if it’s extremely relevant.)

In your dashboard, go to Content in the top bar. Slide the slider in the right column to the period that suits your content type - fewer days for sites with topical articles, more days for those with evergreen content.

Prioritize recency so that content published within a chosen period is more likely to appear as recommendations.

Add a great title

If you want the related content module to stand out, give it a great header that will help your readers know they’re getting more of your own content, and won’t be re-directed elsewhere. “You Might Also Like” or “We Recommend” will do the trick.

 

Location, location, location

Next, drop the code in the appropriate locations and wait for us to import your content and generate recommendations.

Make sure you add our code in the right location: the js and css assets can be added to your header or footer but the <div> snippet you created should only load on pages that you want to feature in the recommendations. if you add it in a widget that appears across all your site, we will import content non-fit for recommendations (contact forms, archives, category pages, etc.)

Support

If you're having difficulties with the Quick Start wizard, please check out our FAQ and troubleshooting page.