Title: Recommendations Block
Author: staff
Published: August 1, 2022
Last modified: November 18, 2025

---

 1. [Installation resources](https://docs.parse.ly/installation-resources/)
 2. [Installation tools](https://docs.parse.ly/installation-resources/installation-tools/)
 3. [WordPress plugin](https://docs.parse.ly/installation-resources/installation-tools/wordpress-plugin/)
 4. Recommendations Block

#  Recommendations Block

## Overview

The Recommendations Block is designed to showcase links to content on your site 
as provided by the [Parse.ly/related API endpoint](https://docs.parse.ly/api/api-endpoints/content-recommendations/#h-get-related).
Add it in Posts, Pages, or nearly any other custom post type. The Block works in
Full Site Editing (FSE) mode or as a [Block-based Widget](https://wordpress.org/documentation/article/block-based-widgets-editor/).

[[

**Note**

The Recommendations Block will completely replace the Recommended Widget in wp-parsely
version 4.0. If you’re using the Widget, Parse.ly recommends migrating to the Block
as soon as possible.

## Requirements

The Block is available only in WordPress 5.9 or later.

## How to use

Inside the Block Editor, add the `Parse.ly Recommendations` Block via the [standard ](https://wordpress.org/support/article/adding-a-new-block/)
[block](https://wordpress.org/documentation/article/adding-a-new-block/)[ controls](https://wordpress.org/support/article/adding-a-new-block/)
and configure its [settings](https://docs.parse.ly/installation-resources/installation-tools/wordpress-plugin/recommendations-block?output_format=md#h-settings)
using the sidebar.

## Customizing the appearance

The Block’s appearance is minimal and inherits the active theme’s styling. At this
moment, the Block doesn’t offer any styling preferences in its settings and its 
appearance is meant to be manipulated using CSS.

## Settings

### Title

Change the Block’s title by updating this setting. Specify an empty value to make
the title section vanish.

### Maximum Results

Specify the maximum number of recommendations to show.

> Note: In certain cases, the number of results might be lower than this setting(
> especially if it is set to a large number).

### Show Images

Toggle this setting to enable or disable images in the results.

### Image Style

Use this setting to specify whether the Block should display the post’s original
image or the respective thumbnail provided by Parse.ly. Selecting the thumbnail 
option could be more performant but is not ideal for displaying large images.

**Note**

If you select the `Parse.ly thumbnail` setting, the image will appear big and distorted.
Use CSS to tailor it to your needs.

### Sort Recommendations

Sort the results by score (of relevance) or published date.

### Additional CSS class(es) (Advanced section)

For styling purposes, specify one or more CSS classes to assign to the block.

## FAQ

### I can’t find the Block

Ensure that you’re running WordPress version 5.9.0 or later, as the Block is unavailable
in lower WordPress versions.

### Images are of low-quality, even though “Image style” is set to “Original”

To resolve this:

 1. Upgrade to [wp-parsely](https://wordpress.org/plugins/wp-parsely/) 3.3.0 or higher.
 2. Contact support@parsely.com and request a [recrawl](https://docs.parse.ly/installation-resources/parsely-integration/metadata/crawler/whats-a-recrawl/),
    mentioning that you’re experiencing an image quality issue with the Block.

Last updated: November 18, 2025