> ## Documentation Index
> Fetch the complete documentation index at: https://amethystapps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpticMatch AI FAQ

Everything you need to know about AI-powered visual recommendations, bundle discounts, and cross-platform setup.

# Frequently Asked Questions

Find answers to common questions about OpticMatch’s AI engine, storefront widgets, and cross-sell capabilities.

***

## General

<AccordionGroup>
  <Accordion title="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).
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

***

## Setup & Installation

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

***

## Recommendations & AI

<AccordionGroup>
  <Accordion title="How does the AI decide which products to pair together?">
    It uses a triple-layer logic:

    1. **Category Rules:** e.g., snowboards are paired with bindings and boots.
    2. **AI Semantic Matching:** OpenAI analyzes titles and descriptions to find logical companions.
    3. **Visual Matching:** CLIP vision models analyze product images for aesthetic compatibility.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

***

## Bundle Discounts

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

***

## Analytics & Performance

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="Where do I see my analytics?">
    All performance data is available under the **Analytics** tab in your app dashboard.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="The Add to Cart button isn't working.">
    We are currently optimizing the "Add to Cart" functionality for certain theme configurations. If you experience issues, clicking the product title or image will still direct shoppers to the product page to complete their purchase.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

***

### Still have questions?

<div class="glass-callout">
  If you couldn't find the answer you were looking for, our engineering team is available to help.

  [Contact Amethyst Support](mailto:support@amethystapps.com) | [Request a Feature](mailto:support@amethystapps.com?subject=Feature%20Request)
</div>