WordPress Troubleshooting

Common questions to issues with the Related Posts by Bibblio plugin

A WPEngine Recommended Plugin

⚠️ Important Notice

This plugin is no longer available for download

Websites that downloaded the Related Posts by Bibblio plugin before 17 August 2020 will not be impacted by this change and will continue to receive support, but no new releases are planned in the near future.

For WordPress users looking to enjoy Bibblio on their site, we recommend using our Quick Start code for an easy plug-and-play installation, or visiting our API documentation for a more custom integration. Both methods are fully compatible with WordPress and give you access to additional features that were not available within the plugin.

Quick Start code API documentation

Module display


I can't find the module on my site.

You've finished installing Bibblio but the recommendations are not appearing on your site. 

Did you remember to select a method for displaying the module? You can set the module to automatically appear beneath the content of all of your posts, add it via shortcode or in a widget. Check our installation guide if you're not sure how to do that.

If you've selected a display method but recommendations aren't appearing, we may still be busy generating recommendations. Please note that, depending on how many posts you are importing, you might need to wait 20-30 minutes the first time around to see recommendations appear.

You can check that the module has been dropped on the page by navigating to your Developer Tools (Win: Ctrl + Shft + I. Mac: Cmd + Alt + I) and looking in the Elements tab (or Inspector tab in Firefox).

Click anywhere in the HTML panel and open the Find Text field (Win: Ctrl + F. Mac: Cmd + F). Then search for the text "bib_" to verify that the module has been dropped on the page.

If you can see the code but the module is still not visible, it's most likely being hidden by your theme. You’ll need to make the appropriate adjustments in your stylesheet to override any overzealous classes.

If you cannot see the code, double-check the Widgets tab in your WordPress admin to ensure that you’ve dropped the widget on the page.

If you added the code using Ad Inserter, our module might be getting blocked by your ad blocker. Disable it and refresh the page to see whether that is the case.

In either event, if the module still does not display, check to make sure that your JavaScript files are loading before the Bibblio module renders. If they’re not, you’ll most likely see an error in your Console tab such as: Uncaught ReferenceError: Bibblio is not defined or jQuery is not defined.


My module appears very squashed on my side bar

This is probably because a horizontally-shaped layout of tiles has been chosen and placed as a widget in your side bar. If you would like it to be a column of tiles, go to the "Modules" tab in your Bibblio plugin admin, select the module from the "My Modules" section, and alter the "Module Layout" to be a column of between one to five tiles. Click Update and your module should correct itself on your site. (Remember, you can make different modules for different parts of your pages, not just one.)

If you want your module to appear below your posts rather than as a column on the sidebar, see the question below...


How do I display recommendations on the bottom of the page, rather than in a sidebar?

You can set the module to automatically appear beneath the content of all of your posts. When you initially run the setup wizard, in the 'Add Module" step, go to the green "Now add the module to your posts" section, slide the setting to on (if necessary, alter the subtitle that will appear above the module) and click Save.

If you've already completed the setup, go to the "Modules" tab in your Bibblio plugin admin. There you'll see the "Automatically feature one module at the end of my posts" dropdown, which lists each of your modules. Choose one of these, (if necessary, alter the subtitle that will appear above the module) and click Save.

The widget can also be dragged into the footer of the page by going to Appearance > Widgets in your WordPress admin. There you’ll see a series of widgetized areas on the right. Expand the footer area you want to add the widget to (hover over it and click on the down arrow on the right), then drag the Bibblio widget to the expanded area.


Can I use shortcodes to display the recommendations?

Yes, you can use shortcodes to display a related posts module within the body of your post. When editing a post in 'Visual' mode, click on the line you would like the module to appear on, then click on Bibblio's "Insert Shortcode" icon in the toolbar. A popup window will ask you to select which of your modules you'd like to insert. Choose one and click OK.

If you're using the Classic Editor plugin, please note we are not yet integrated into this, so you can instead grab a Bibblio shortcode from this How-to guide and paste it directly.


How do I insert shortcodes on every page?

If you'd like to use shortcodes across posts, you can drop the shortcode directly into the theme's template. Go to Appearance > Editor and navigate to the relevant post template. In the template's source code, in the section bracketed by <?php ... ?>, you can insert

echo do_shortcode('[YOUR BIBBLIO SHORT CODE]');

replacing "YOUR BIBBLIO SHORT CODE" with the shortcode (see previous question regarding getting your shortcode), and it will show up across all pages.

If you're using the Classic Editor plugin, please note we are not yet integrated into this, so you can instead grab a Bibblio shortcode from this How-to guide and paste it directly.


The recommendations display a gray image instead of images from my posts.

Currently, the plugin will only pull images that have been set as featured images. If you’d like to convert your existing images into featured images, here’s a helpful plugin you can use.


My images are blurry/low quality on the recommendations.

The plugin pulls in your featured images as "Medium" sized. By default, WordPress creates a medium-sized image by limiting the width or height (whichever is largest) to a maximum 300 pixels, scaling the image proportionally. When using some of our plugin layouts the image may have to stretch to fit a tile wider than 300 pixels. This causes the images to look blurry or of a low quality. We're looking into improvements to automatically resize your existing images to better display on your recommendations.

In the meantime, to ensure a better image quality for all of your future posts, go to Settings > Media, change the Medium size Max Width to 400 and Max Height to 600. Then click Save Changes. This will make all newly-created medium-sized images slightly larger, even in portrait orientation.

If you wish to change the "Medium" size of your existing featured images, there are a variety of plugins available to automatically resize them to your desired dimensions. Once complete, you will need to re-import your posts so that Bibblio knows the new image URLs for each. Find out how to clear your catalogue in order to re-import your content here.


Can I customize the title font and other elements?

If you want to change the font or text size of the headline, you can set these in your module editor. Go to Modules, select the module you wish to edit, and under "Headline Style" you can choose a recommended system font (to ensure it looks the same on Windows and Apple devices) and the text size.

If you wish to use a non-standard font for your headline, you can do this within your own stylesheet, altering the '.bib__title' class. (Be sure your stylesheet loads after ours, and include !important in the parameter to guarantee you'll override our settings.)


.bib__title {
    font-family: “Roboto”, sans-serif !important;

You can use this class to override the headline color and similar parameters.

Alternatively, if you wish to change the font for the entire module (including the author, date and description in all tiles) you can use your stylesheet again, but this time targeting the '.bib__info' class. (We recommend a simple, sans-serif font is used for this small text to ensure legibility.)


.bib__info {
    font-family: “Roboto”, sans-serif !important;



Post management


The module is recommending posts from my staging environment.

If you've used the same Bibblio credentials to import content from your testing and production site, these will all be stored in the same catalogue. Ask us to clear your catalogue and start fresh. You will need to go through the installation wizard again, so don't forget to make a note of your modules' settings.

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

If you want to keep one account only, just make sure you clear your catalogue once you're ready to move Bibblio to your live site so that the staging urls don't appear in the recommendations.


Error importing - error communicating with Bibblio server.

This is a generic error message and could be due to the following reasons:

  • You have reached your storage limit available on your plan, so new posts cannot be imported to Bibblio. If that's the case, upgrade your account to increase your storage allowance.
  • Your posts don't have a title and/or text
  • You are using a page builder that creates text "blocks", or "modules". these tend to output content as shortcodes, which we cannot import. Gutenberg Editor is fine!


I’ve installed the plugin, but my posts aren't importing.

Check to make sure that cron jobs are enabled. Open the wp-config.php file in the root of your WordPress installation and ensure the code DISABLE_WP_CRON is set to false.

A few other factors may be blocking the importer from running:

  • Your posts don't have a title and/or text
  • You are using a page builder that creates text "blocks", or "modules". these tend to output content as shortcodes, which we cannot import. Gutenberg Editor is fine!

If this applies to you, consider installing Bibblio with our Quickstart code instead.


How do I exclude individual posts from being recommended?

To exclude individual posts from your recommendations, just untick the box called Import post to Bibblio in the lower right-hand corner of the Edit Post page.

If you have a few posts you want to exclude from being recommended, you can use our "Bulk Edit" option. In your WordPress admin, go to Posts > Bulk Actions > Edit, select the posts you want to exclude and click Apply. In the panel that appears, select No from the "Import to Bibblio" dropdown.


How do I exclude certain post types or categories from being recommended?

When installing the plugin, you can indicate which post types to ingest. Simply unselect any types that you do not want to include in your recommendations.

You can't currently choose to display posts by category using our plugin. It's worth noting that since our recommender engine finds the most relevant posts for a piece of content, it is likely the recommendations will come from the same category anyway. 

If there is a specific reason why you would want to exclude a category from displaying in the recommendations (for example, not wanting product reviews to appear in a Bibblio widget you named "More Delicious Recipes"), talk to us about using the Quick Start code instead of the plugin.


Can I disconnect the plugin from one of my environments only?

No. Widget disconnection will apply to all of your environments at once. E.g. If you disconnect the widget from your development environment it will instantly disconnect from your live environment too.

Disconnection will detach all of your posts from Bibblio. Your actual posts within WordPress will not be affected but all Bibblio widgets within them will not appear.

You can reactivate the widget at any time using your Bibblio client ID and client secret. You will need to reimport your posts and create your modules again. Any analytics data from previous activations will be preserved.

Related guides


If you haven't found the answer, perhaps our WordPress FAQs can help.