Everything you need to know about AI-powered visual recommendations, bundle discounts, and cross-platform setup.Documentation Index
Fetch the complete documentation index at: https://amethystapps.com/llms.txt
Use this file to discover all available pages before exploring further.
Frequently Asked Questions
Find answers to common questions about OpticMatch’s AI engine, storefront widgets, and cross-sell capabilities.General
What does OpticMatch do?
What does OpticMatch do?
OpticMatch automatically recommends complementary products on your product pages using AI. When a shopper views a product, a “Complete the Set” widget appears below showing items that pair well with it—encouraging them to add more to their cart and increasing your Average Order Value (AOV).
How is this different from other upsell apps?
How is this different from other upsell apps?
Most upsell apps use manual rules or basic “customers also bought” data. OpticMatch uses OpenAI and CLIP vision models to analyze your products and generate intelligent pairings based on product type, description, and visual style—no manual setup required.
Which platforms and themes are supported?
Which platforms and themes are supported?
- Shopify: Works with any Online Store 2.0 theme. Older “vintage” themes are not supported.
- BigCommerce: Compatible with all modern Stencil-based themes and headless builds.
Setup & Installation
How do I install the widget on my store?
How do I install the widget on my store?
- Shopify: Go to your Theme Editor → Add Section/Block → find “Complete the Set” and add it to your product page template.
- BigCommerce: Use the native Page Builder to drag the OpticMatch component into your layout, or use our Script Manager integration.
Do I need to do anything after installing?
Do I need to do anything after installing?
No. Once installed, the AI automatically begins generating recommendations for your catalog in the background. You can track the progress via the indicator in your admin dashboard.
How long does it take to generate recommendations?
How long does it take to generate recommendations?
It depends on your catalog size. Most stores with under 1,000 products are fully processed and ready within a few minutes.
Can I customize how the widget looks?
Can I customize how the widget looks?
Yes, fully. From the theme editor (Shopify) or Page Builder (BigCommerce), you can change the heading, colors, number of cards shown, button text, card style, and badges to ensure a native brand experience.
Recommendations & AI
How does the AI decide which products to pair together?
How does the AI decide which products to pair together?
It uses a triple-layer logic:
- Category Rules: e.g., snowboards are paired with bindings and boots.
- AI Semantic Matching: OpenAI analyzes titles and descriptions to find logical companions.
- Visual Matching: CLIP vision models analyze product images for aesthetic compatibility.
Can I create my own pairings manually?
Can I create my own pairings manually?
Yes. In the admin under Recommendations, you can click “Create Pairing” to manually link any two products, giving you full control over your merchandising strategy.
How do I regenerate recommendations?
How do I regenerate recommendations?
If you’ve made major changes to your catalog, go to the Recommendations tab and click “Regenerate All Recommendations”. This re-runs the AI engine across your entire store.
Why are some products not getting recommendations?
Why are some products not getting recommendations?
The AI needs enough context to make a smart match. Ensure your products have descriptive titles, clear product types, and images set in your store admin.
Bundle Discounts
What is a bundle discount?
What is a bundle discount?
A “Buy Both & Save” offer that appears within the OpticMatch widget. When a shopper clicks it, both products are added to their cart with a discount code automatically applied at checkout.
How do I set up a bundle discount?
How do I set up a bundle discount?
Go to the Bundle Discounts tab in the app admin, select two products you want to pair, and set your desired discount percentage. The app handles the rest via the Shopify/BigCommerce Discount APIs.
Analytics & Performance
What metrics does the app track?
What metrics does the app track?
- Impressions: How many times the widget was seen.
- Clicks: How many times a recommended product was clicked.
- Add to Carts: How many times a product was added directly from the widget.
- CTR & Conversion Rate: Calculated metrics to help you identify your top-performing product pairings.
Where do I see my analytics?
Where do I see my analytics?
All performance data is available under the Analytics tab in your app dashboard.
Troubleshooting
The widget isn't showing on my product page.
The widget isn't showing on my product page.
First, ensure you have added the app block in your theme editor. Second, check the app admin to verify that recommendations have finished generating for that specific product.
The Add to Cart button isn't working.
The Add to Cart button isn't working.
What happens to my data if I uninstall?
What happens to my data if I uninstall?
Your recommendations and settings are preserved in our secure database. If you reinstall the app later, your configuration will be exactly where you left it.
I uninstalled but the widget is still showing.
I uninstalled but the widget is still showing.
On Shopify, you must manually remove the “Complete the Set” block from your theme editor to stop it from rendering. On BigCommerce, simply remove the script or component from your Page Builder.
Still have questions?
If you couldn’t find the answer you were looking for, our engineering team is available to help.Contact Amethyst Support | Request a Feature