Creating a Wishlist similar block
A Wishlist similar block recommends products similar to the ones a user has added to their wishlist. It is structured like the Cart similar (opens in a new tab) block. The screen has the same layout, but the source is the wishlist instead of the cart, and some fields have their own labels.
1. Creating the block
In the Name field, enter a name. In the "Type" field, select "Similar Products to Wishlist Block", and specify a a unique identifier used to retrieve the entity. When you click Add, the block appears in the table.
2. Editing the block
The block settings screen has the following sections:
- Details: Name* and Marker
- Block settings (the Settings for 'Similar to wishlist' block card, with a Help button next to it): Maximum number of products, Exclude items from wishlist, Fallback to trending when wishlist is empty
- Audience filter
- Automatic matching by attributes (Match by attributes)
- Selection of similar products
- Context for preview, with the Test wishlist (product IDs) field
- Preview
Automatic matching by attributes
This is the main section. Select the attributes used to find similar products:
- Set of attributes: the attribute set that supplies the characteristics to compare.
- Attributes for comparison: the attributes whose matching values determine which products are similar.
- Minimum matches: how many of the selected attributes must match for a product to appear in the results.
To see why a product appears in the Found products preview, open the Explanation tab in the Block preview (opens in a new tab) window. An attribute match is marked with a Matching attributes badge that lists the matched attributes and their count, for example "Matching attributes: color, brand (2)".
Selection of similar products
Below the Match by attributes section is the Selection of similar products section, the same one as in the similar products block in automatic mode (opens in a new tab). Similar products are selected for each wishlist item based on the meaning of its description and are recalculated on every request, so when the wishlist changes, the selection changes too.
- How important is a close price: a slider from 0 to 1. The higher the value, the further down the list products priced far from the source product move. At 0, price is not considered.
- What kind of product should be to get into the block: required conditions. A product gets into the block only if all of them are met. A "matches" condition compares against the value of the source product. This section also has the Non-indexed products checkbox, which sets whether to include products that have not been indexed yet.
- Show as a single card products that match by: the criteria by which variants of one product (sizes, colors) are shown as a single card: the Title checkbox and attributes grouped by set. If nothing is selected, each product gets its own card.
- Where to search for similar products: the categories that similar products come from. If none are selected, the search covers the product's own categories. Selected categories replace that scope entirely.
Below the settings, diagnostics for the saved block show how many products are in the catalog, how many models remain after merging, and how many products end up with fewer than two similar ones.
The Found products preview is built from the Test wishlist (product IDs) field in the Context for preview section: comma-separated product IDs (up to 50).
Audience filter
For the block's audience, see Audience Filter (opens in a new tab).
Preview
The Open in modal button opens the Block preview (opens in a new tab).
The screens of these two blocks have the same layout, but each has its own field labels. Cart similar uses Maximum items, Exclude items from cart, Fallback to trending when cart is empty, and Test cart (product IDs). Wishlist similar uses Maximum number of products, Exclude items from wishlist, Fallback to trending when wishlist is empty, and Test wishlist (product IDs). The functional difference is the source: Cart similar looks at the cart, and Wishlist similar looks at the wishlist. Choose the block type based on the site screen where the block will appear.