Product Mappings

Product mapping lets you create custom rules for product recommendations. Instead of relying on automatic suggestions, you decide exactly which products to recommend based on what's in the customer's cart.

desc - Create custom product-to-product recommendation rules based on cart contents.

Example: When a customer adds a camera to their cart, you can automatically recommend a specific memory card and camera case - products you know work well together!

---

How to Set It Up

Step 1: Access Product Mapping

1. On the sidebar of the app dashboard, click on the Product Mappings tab

Step 2: Create a New Mapping

1. Click the "Create new mapping" button
2. You'll see a form with two main sections: Triggers and Recommendations

Step 3: Set Up Triggers (What's in the Cart)

Triggers are the products that, when added to the cart, will activate your recommendation.

1. In the "Trigger Products" section, click "Add product"
2. Search for and select a product from your store
3. (Optional) Set a minimum quantity - e.g., "Recommend only if they have 2 or more of this sku"
4. (Optional) Add multiple products - the customer must have ALL of them for the recommendation to show (AND logic)

Example Triggers:

• Single product: "Camera Body" → recommend accessories
• Multiple products: "Camera Body" AND "Lens" → recommend a camera bag
• With quantity: "3 or more T-shirts" → recommend a matching hoodie

Step 4: Set Up Recommendations (What to Suggest)

Recommendations are the products you want to suggest when the triggers match.

1. In the "Recommended Products" section, click "Add product"
2. Search for and select products to recommend
3. You can add multiple products - all of them will be shown to the customer

Step 5: Enable Your Mapping

1. Make sure the "Enabled" toggle is turned ON (green)
2. Click "Save" to activate your mapping
3. Disabled mappings (toggle OFF) are saved but won't show recommendations

Bulk Import with CSV (Advanced)

For stores with many product combinations, you can import mappings in bulk:

1. Click the "Download template" button
2. Fill in your mappings in the CSV file:
   • Column A: Trigger Product ID
   • Column B: Quantity (optional)
   • Column C: Recommended Product ID
3. Upload your completed CSV file via the "Import CSV" button
4. Choose an import type (replace or append) and click "Import"

Configuring Components to Use Product Mapping

After creating mappings, you need to set your components to use them:

1. Edit or create an upsell component
2. Find the "Recommendation sourcing" section
3. Select "Product Mapping" as the source
4. Save your component

What Your Customers See

When a customer shops:

1. They add a product to their cart (that matches one of your triggers)
2. Your upsell component automatically displays the products you mapped
3. They see perfectly matched recommendations based on your expertise
4. If no mappings match, the component can fall back to automatic recommendations (if configured)

Example Customer Journey:

• Customer adds "Professional DSLR Camera" to cart
• Your mapping triggers
• They see recommendations for: "64GB Memory Card", "Camera Case", "Extra Battery"
• All recommendations are products YOU specifically chose

---