Skip to main content

Creating a Cart complement block

A Cart complement block recommends products that go well with what the user has already added to the cart: a mouse for a laptop, or a belt or bag for a dress.

1. Creating a block​

To create a "Cart complement" block, enter the block name in the Name field, select "Cart Complement Block" from the "Type" dropdown, and enter a unique unique identifier used to retrieve the entity. Click Add, and the block appears in the blocks table.

2. Editing a block​

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

Edit

The block screen opens on the Basic data tab. Next to it are the Linked pages tab (links the block to pages) and the Version History tab (change history). They work the same way as for a regular block (opens in a new tab).

The Basic data tab has the following sections:

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

Basic data​

The basic fields: Name and unique identifier used to retrieve the entity.

Settings for 'Complement Your Cart' block​

The main block settings. The following fields are available:

  • Maximum items: the maximum number of products the block returns.
  • Exclude items from cart: a checkbox. When it's selected, the block doesn't return products the user has already added to the cart. Usually you should keep it selected.
  • Fallback to trending when cart is empty: a fallback checkbox. If the cart is empty or no complements are found, the block shows trending products instead of returning nothing. Below these settings is the Audience filter card, then a separate Context for preview card with the Test cart (product IDs) field, and below that the Found products preview card with the Open in modal button. In the Test cart field, enter the IDs of the products "in the cart," separated by commas (up to 50 values). If the field is empty, the preview shows nothing.

A Help button with a detailed explanation is available next to the Settings for 'Complement Your Cart' block heading, above the Audience filter card, and next to the Open in modal button above the Found products preview.

Tip

Keep "Fallback to trending when cart is empty" enabled. Otherwise, when the cart is empty, the block shows nothing and leaves a blank space on the storefront.

This block type has a single selection algorithm: you configure only the limit, exclusions, and fallback.

Audience filter​

To show the block only to certain user segments, use the audience editor. See Audience Filter (opens in a new tab).

Preview​

The "Open in modal" button opens Block preview (opens in a new tab), a preview window with three tabs:

  • Basic: a table of the products the block returns with the current settings.
  • Explanation: badges for each returned product that show why it was included in the block and why it has its position.
  • Investigate: diagnostics, including which audience rule matched, which warnings the system issued, and whether the fallback ran.
Last updated on