Clerk.io Developer Documentation

Welcome to the Clerk.io Developer Documentation.

Here you find our developer documentation for our API and all our SKDs.

Get Started    

Excluding Products

Exclude Specific Products

To avoid recommending products already in the shopping cart, simply add the attribute data-exclude to the recommendation embed codes.

The content of data-exclude should be a list of the product IDs you don't want to be shown in the recommendations - ie. the products in the customer's shopping cart.

<span class="clerk"
  data-template="@clerk-complementary"
  
  data-exclude="[45654]">
</span>
<span class="clerk"
  data-template="@clerk-complementary"
  
  data-exclude="[123, 456]">
</span>

Exclude Duplicates

🚧

Be aware of slower load times

Using this feature forces the loading of multiple Clerk.io recommendations one after each other, instead of at the same time, thus adding a extra weight to the page load time.

Make sure the tradeoff in load time is worth avoiding the duplicates.

Clerk.js provides a simple way to prevent duplicates across multiple recommendations sliders on the same page.

This is done by adding the data-exclude-from attribute on the Clerk Block wherever you want to remove the duplicate from. The value of the attribute should be a CSS selector to the other block to prevent duplicates from.

In the example below, the #clerk2 slider excludes any product that is in the #clerk1 slider, and the #clerk3 slider excludes any products that are in either #clerk1 or #clerk2.

<span class="clerk"
  id="clerk1"
  data-template="@clerk-banner-1">
</span>
 
<span class="clerk"
  id="clerk2"
  data-exclude-from="#clerk1"
  data-template="@clerk-banner-2">
</span>
 
<span class="clerk"
  id="clerk3"
  data-exclude-from="#clerk1,#clerk2"
  data-template="@clerk-banner-3">
</span>

You can also limit the exclusion to only show the first n products (a smart move if you have a slider with 20 products but where only 4 are visible at a time).

This is done via the :limit(n) option (where n is the first number of products you want to exclude from).

Here is the same example as above, but where the exclusion id only regards the first 5 products.

<span class="clerk"
  id="clerk1"
  data-template="@clerk-banner-1">
</span>
 
<span class="clerk"
  id="clerk2"
  data-exclude-from="#clerk1:limit(5)"
  data-template="@clerk-banner-2">
</span>
 
<span class="clerk"
  id="clerk3"
  data-exclude-from="#clerk1:limit(5),#clerk2:limit(5)"
  data-template="@clerk-banner-3">
</span>

Updated 3 years ago

Excluding Products


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.