Quick Start Troubleshooting

Common issues resolved for the Quick Start wizard

I’ve gone through the installation steps, but the module is not appearing

  1. Code is missing or erroring

    Open the developer tools on one of your article pages and check for our code in the head and the body. Performing a text search for “bib-” will likely reveal us. If it’s all there, check for error messages in the Console. This will help you solve the issue.

  2. Domain has not been whitelisted

    You need to whitelist the exact domain you want to use Bibblio on, including staging sites and subdomains. The whitelisting is case-sensitive, so mydomainname.com will work but MyDomainName.com will not.

  3. Unable to determine canonical URL for auto ingestion

    Check out how to specify a customUniqueIdentifier, or add a canonical tag.

    We use canonical urls to automatically generate post IDs which are essential to index your content. If you don’t have canonical URL tags, it’s very helpful to create one for your posts (and not just to use Bibblio!). You can however still use Bibblio without them by providing your own set of IDs.

    Not sure what the deal is for your site? Open your dev console on one of your article pages and do a search for “canonical”. It should look something like this:

    <link rel="canonical" href="https://www.bibblio.org/blog/making-most-of-every-page">

  4. Error returned is "customUniqueIdentifier must be unique or null"

    This is normal when you first install the module, or on an article that has just been published. You should wait 10-15 minutes, clear your cache and recommendations will appear. If you feel like you’ve been waiting a while, make sure at least five URLs have been visited on your site or get in touch with support.

  5. The module is ad blocked

    If you added our code snippet using Ad Inserter or a similar plugin, chances are our module will get ad blocked. Simply revert to adding the code via an HTML inserter or directly to your template.

The recommendations are linking to my staging environment

We recommend using two accounts for live and staging. If you want to use the same email address for both accounts, use the "+" function, if your mail system permits. For example, jane.smith@mail.com and jane.smith+staging@mail.com.

If you want to keep one account only, contact us and we’ll clear your content so you can start fresh after deploying your site to your live environment.

My recommendations aren’t relevant to the content

We apply a recency boost by default so that newer content is weighted to appear more often. If you have a small corpus and/or don’t publish often, you might want to alter this setting or turn it off entirely. You can find your recency slider in your Bibblio account in the Content section. Once you apply the change, you should wait 24 hours to see the changes apply.

I'm seeing non-article pages appearing as recommendations

If you only want articles to appear in the module, make sure our snippet is placed in the correct template. If you are using the same template for different types of content (for example, videos and articles) but only want Bibblio to index some of that content you’ll need to specify a condition to selectively load our module on the right pages.

You will need to ask us to wipe your contents once you’ve made the changes so we can re-ingest again.

My thumbnails are displaying a gray image

The module defaults to a gray background when we have not found an image in your article. If you don’t have any images, you can change to a text-only display with your own CSS, or add some generic images to the background of your Bibblio tiles. We’ve detailed the steps in this blog post, in the section “Provide alternatives for posts that have no images”.

If you do have images in your posts but we didn't import them, this may be related to how they are being added to your template. Did you insert your images using a content container that executes JS? Did you implement lazy loading? In order to import your content to Bibblio as quickly as possible, we use a crawler that does not execute JS on its first attempt. Any images inserted this way may not have been picked up. 


If you haven't found the answer, perhaps our Quick Start FAQ can help.

If you're still having difficulties please get in touch and a member of Bibblio Support will be happy to assist.