Set up an upsell engine
Create an EliteAI™ upsell engine, choose its base algorithm, and limit or steer what it offers with the Simple or Advanced setup.
Last updated
An upsell engine decides what EliteAI™ may offer and which products it prefers. Each EliteAI™ offer screen uses one engine, and you can reuse an engine on as many screens as you like. This article explains how to create an engine, choose its base algorithm, and set its rules.
Where engines live
Go to EliteAI™ & discounts in the app's menu. The Upsell engines tab lists your engines, with each one's Status, the base algorithm it's Based on, its Setup (Simple or Advanced), and the flows it's Used on. Click an engine's name to edit it.
Every store starts with one engine, My engine. You can have up to 10 engines.
Create an engine
Click Create upsell engine. The app creates an engine straight away, named after its base algorithm, for example EliteAI™ Ultra engine, and opens it. Change the Name if you like, set it up as below, and save from the save bar. Your buyers never see engine names.
Choose a base algorithm
The Base algorithm card is where EliteAI™'s picks start from. Click Select on one:
| Base algorithm | What it recommends |
|---|---|
| EliteAI™ Ultra (recommended) | Products customers most often buy together with the item in the order. Best for accessories, refills and natural add-ons. |
| EliteAI™ Ultra CrossCategoryBoost | Complementary products from product types other than the order item. Best for broadening the basket and product discovery. |
Your engine's rules then narrow and reorder what the base algorithm suggests.
The Simple setup
A new engine uses the Simple setup. Under the engine's name, the page says Simple setup · Switch to advanced. It has four cards:
- Limit recommendations to: tick Specific collections, Products with specific tags or Specific product types, and add the values. A product needs to match only one of them. Leave all unticked to offer any product.
- Exclude from recommendations: tick Specific products, Specific collections or Products with specific tags to keep them out.
- Only recommend products within a certain price range: tick Minimum or maximum price and enter either or both, in your store's currency.
- Price preference: under Prefer products that are, choose Much cheaper, Cheaper, No preference, Pricier or Much pricier, compared with the price of the item in the order. A new engine prefers Cheaper.
Unticking a box clears its values.
The Advanced setup
Click Switch to advanced for if-then rules and boosts. Everything you set in the Simple setup carries over. You can switch back with Switch to simple as long as your rules still fit the Simple setup; otherwise the page says These rules are too detailed for the simple setup. To switch either way, save or discard your changes first.
The rules talk about the trigger item: a product in the buyer's order. EliteAI™ looks at several items in the order, checks each one and its best matches, then chooses the best final pick.
Filters
Filters are hard rules: a product that doesn't pass them is never offered by this engine. Each filter reads If the trigger item (any item, or ones matching your conditions) then recommend products that match your conditions. For example: only products under a price, only products of the same product type as the trigger item, or only products from a different vendor.
- Add filter adds a filter, Add condition adds a condition to one, and Add group groups filters.
- Choose with Or | And whether a product must pass any or every filter.
- You can have up to 5 filters or groups.
Conditions can use the product's price or its price compared with the trigger item, tags, vendor, product type, collection, title, a metafield, or specific products.
Boosts
Boosts are soft rules: they make products more or less likely to be picked without removing any. Each boost reads Boost or dampen products that match a tag, vendor, product type, collection or metafield, for example ones that share a collection with the trigger item. Choose its Effect: Strongly dampen, Dampen, Neutral, Boost or Strongly boost.
A metafield boost looks at one product metafield you pick, and products can:
- have the same metafield value as the trigger item: they share at least one value. A list metafield counts each of its values.
- have none of the trigger item's metafield values: both have a value, and none is shared.
- have one of these metafield values: they have a value from the list you enter.
An engine with a metafield boost stays on the Advanced setup.
The price row, Prefer recommendations that are cheaper or pricier than the trigger item, is a boost too. Click Add boost to add one; an engine has at most 10 boosts.
Fallback
When an engine's filters are strict, some orders may have no product that passes them. Tick If nothing passes the filters, use the base algorithm's picks in the Fallback card to offer the base algorithm's picks then, without this engine's filters. The offer's discount still applies. With the box unticked, which is the default, the screen is skipped for that order.
Exclude products from every engine
On the Upsell engines tab, the Exclude products by tag card lists tags whose products EliteAI™ never recommends, whatever the engine. New stores start with _elite_ai_exclude: add that tag to a product in Shopify to keep it out of EliteAI™. Add or remove tags, then save from the save bar. Gift cards and subscription-only products are never offered either.
In each engine, these tags show as Always excluded.
Delete an engine
Click Delete engine at the foot of the engine's page. You can't delete an engine that a flow still uses (archived flows don't count): the app lists those flows, so you can pick another engine on their EliteAI™ offers first. Your only engine can't be deleted either; create another one first.
Still stuck?
Chat with us and we'll help you get your offer live. Or email contact@elitecart.app.