How Product Logics work

See a detailed list of the Product Logics available in Clerk.io, how they show the products they do and which endpoints they use.

Clerk.io has many different Product Logics that allows you to show the right products anywhere whether that is by using Recommendations, Search or Email.

Use the below table to get an overview of how each of them works.

Product LogicDescriptionAPI Endpoint
Best SellersThe most popular products in your store, that have been included in the most amount of orders for the longest time. The amount of the same products in each order makes no difference. Usually stays the same for extended periods as long as you have the same products in stock.View in docs
Hot ProductsProducts that recently saw an increase in sales. No specific time frame is used - it is calculated dynamically based on changes in how the products sell. E.g. if a product normally sells 3 times pr. week but suddenly sells 20 times in two days, a trend is happening.View in docs
Newest ProductsProducts that were most recently added to the store, with the newest ones shown first. Requires the attribute “age” or “created_at” to be present on products.View in docs
Best Sellers In CategoryThe most popular products within a specific category.View in docs
Hot Product In CategoryProducts that recently saw an increase in sales within a specific category.View in docs
Newest Products In CategoryProducts that were most recently added to a specific category, sorted by newest first. Requires the attribute “age” or “created_at” to be present on products.View in docs
Best Alternative ProductsProducts that are the closest matches to the product being viewed, sorted by popularity. Finds products based on all available attributes like name, brand, category, price and any other data that makes the products similar.

  • Fallback 1: If an unknown product ID is provided, Visitor Recommendations are shown.
  • Fallback 2: If the visitor is not known, Best Sellers are shown.
View in docs
Best Cross-Sell ProductsProducts that are most likely to be bought with the product being viewed. This is both based on the actual products bought with it, but also products that are likely to be a good match, e.g. a belt for a pair of pants. We measure this by analysing which types of products are normally bought together, to allow the same types of recommendations to be displayed even for products that have not been bought together yet.

  • Fallback 1: If an unknown product ID is provided, Visitor Recommendations are shown.
  • Fallback 2: If the visitor is not known, Best Sellers are shown.
View in docs
Most Sold WithThe products that have been sold most with any given product or multiple ones. This logic is a lot simpler than Best Cross-Sell Products, as it does not predict any new products to show, but simply counts the ones that have been sold most with the given product(s).View in docs
Recommendations Based On Keywords Products matching a specific keyword or phrase, sorted by how much they sell.View in docs
Specific ProductsThe exact products specified. If configured to show a higher Number of products than specified, results will be filled with Best Sellers.
Visitor RecommendationsProducts that are most likely to be bought by a visitor, based on their most recent browsing. Uses a combination of cross-sell and alternatives to find the best matches for each visitor.

  • Fallback: If the visitor is unknown, Best Sellers are shown.
View in docs
Visitor AlternativesSimilar products that are most likely to be bought by a visitor, based on their most recent browsing.

  • Fallback: If the visitor is unknown, Best Sellers are shown.
View in docs
Visitor Click HistoryThe exact products clicked by a visitor.

  • Fallback: If used in Recommendations Content, no fallback is used.
  • If used in Email Content, Best Sellers are used when the visitor is unknown.
View in docs
Recommendations Based On OrdersProducts that are most likely to be bought by a customer, based on their previous purchases. Uses a combination of cross-sell and alternatives to find the best matches for each visitor.

  • Fallback 1: If the customer is unknown, Visitor Recommendations are shown.
  • Fallback 2: If the visitor is not known, Best Sellers are shown.
View in docs
Similar To Order HistorySimilar products that are most likely to be bought by a customer, based on their previous purchases.

  • Fallback 1: If the customer is unknown, Visitor Recommendations are shown.
  • Fallback 2: If the visitor is not known, Best Sellers are shown.
View in docs
Customer Order HistoryThe exact products bought by a customer.

  • Fallback: If used in Recommendations Content, no fallback is used.
  • If used in Email Content, Best Sellers are used when the visitor is unknown.
View in docs
What Customers Look At Right NowProducts most recently clicked on by any visitor on the webshop. View in docs
Recently Purchased ProductsProducts most recently bought by any customer on the webshop. View in docs
Best Page AlternativesBest similar pages to the one currently viewed. Analyses all text of the page to find keywords related to other pages.View in docs
Pages Related To A ProductBest matching pages for the product being viewed. Analyses the products data and compares it to pages that mention the product or related concepts.View in docs
Pages Related To A CategoryBest matching pages for the category being viewed. Analyses the category’s data and compares it to pages that mention the category or related concepts.View in docs
Products Related To A PageBest matching products for the page being viewed, sorted by popularity. Analyses all text of the page to find keywords related to the specific productsView in docs
Categories Related To A PageBest matching categories for the page being viewed, sorted by popularity of the products within them. Analyses all text of the page to find keywords related to the specific categoriesView in docs
Live SearchPredicts what the visitor is trying to find, by auto-completing their query and showing the best matches sorted by trends, like Hot Products.View in docs
SearchShows the best matches sorted by popularity, for the exact query a visitor typed.View in docs
Categories SearchBuilt-in to Live Search by default. Shows results based on categories matching the search terms. Uses any text available on categories like name, description etc.View in docs
Pages SearchBuilt-in to Live Search by default. Shows results based on pages matching the search terms. Uses any text available on pages like title, text, type etc.View in docs