Skip to main content

Creating a Cart Complement Block

The Cart Complement block is designed to recommend products that nicely complement what the user has already added to their cart. For example, a mouse for a laptop, or a belt or bag for a dress.

1. Creating the Block​

To create a block of type "Cart Complement," you need to enter the block name in the Name field, select "Cart Complement Block" from the dropdown list in the "Type" field, and enter a unique

Marker
. After clicking the Add button, the block will appear in the blocks table.

2. Editing the Block​

To edit the block, click the "Edit" button in the "Actions" column:

Edit

The block settings screen is divided into the following sections:

  • Basic data
  • Settings for 'Complement Your Cart' block
  • Audience filter
  • Context for preview
  • Preview (Open in modal)

Basic Data​

Basic fields: Name and

Marker
.

Settings for 'Complement Your Cart' Block​

The main section of the block settings. Next to the key fields is a Help button with detailed explanations. The following fields are available:

  • Maximum items — the maximum number of products that will appear in the block's output.
  • Exclude items from cart — checkbox: if checked, products that the user has already added to the cart will not be included in the output. It is usually advisable to keep this checked.
  • Fallback to trending when cart is empty — fallback checkbox: if the cart is empty or no complements are found, the block will show trending products instead of an empty output.
  • Test cart (product IDs) — context for preview: a comma-separated list of product IDs "in the cart" (up to 50 values). If the field is empty, the preview will show nothing.

Below is the Audience filter card, and beneath it is the Context for preview section with the Test cart field and the Found products preview.

💡Tip

Keep "Fallback to trending when cart is empty" enabled — otherwise, with an empty cart, the block will show nothing, leaving a blank space on the display.

The selection algorithm for this type of block is straightforward: only the limit, exclusions, and fallback settings are configured.

Audience Filter​

To ensure that the block is visible only to specific user segments, use the audience editor — see Audience Filter.

Preview​

The "Open in modal" button opens the Block preview — a preview window with three tabs:

  • Basic — a table of products that will appear in the block's output based on the current settings.
  • Explanation — for each product in the output, badges with reasons: why it was included in the block and why it is in that position.
  • Investigate — diagnostics: which audience rule was triggered, what warnings the system issued, and whether the fallback was activated.