Watch
See Visual Upsell by Amethyst in action
A short look at Visual Upsell by Amethyst, the Shopify upsell and cross-sell app from Amethyst Apps. It adds a Complete the Set section to product pages, recommending products that match in colour, style and finish using AI image matching, order history and product details, with Buy Both & Save bundle discounts.
Watch on YouTube (opens in a new tab)Before you begin
Good product data makes better pairings
Recommendations are only as good as the information they are built from. A few minutes tidying your catalogue first will noticeably improve the results.
Images matter most. The app looks at each product's photos to judge colour, style and finish, so a clean, well-lit main image for every product gives the best matches.
Titles, descriptions, product types, tags and image alt text are used alongside the images.
Products that customers already buy together become co-purchase recommendations automatically.
Complete the Set is an app block, added through the Shopify theme editor.
Step one
Install Visual Upsell by Amethyst
- Open Visual Upsell by Amethyst in the Shopify App Store.
- Select Install and choose the correct Shopify store.
- Review the requested product, order and discount permissions.
- Approve the installation and open the app from Shopify admin.
Step two
Sync your products and orders
- Open the app. It starts importing your products, collections and the last 60 days of order history straight after installation.
- Check the sync status on the Dashboard.
- Select Sync now if you have just made changes you want included.
After the first sync the app keeps your catalogue up to date as products change, with an automatic sync every 24 hours.
Video guide
Watch: syncing your products
Visual Upsell needs a copy of your catalogue before it can pair anything. The first sync starts when you install, products sync again every 24 hours, and Sync Now picks up new products straight away.
Watch on YouTube (opens in a new tab)Step three
Generate and review recommendations
- Go to Recommendations and select Regenerate all.
- Wait for the progress banner to finish. Larger catalogues take longer.
- Review the pairings and delete any you don't want shown.
- Select Create pairing to add a recommendation of your own.
Each pairing is labelled Perfect Match, Style Match, Goes Well, Co-purchased or Manual, so you can see where it came from.
Products your customers have bought together in the same order.
AI matches based on complementary product types and categories.
AI matches found by looking at your product images: products whose colour, style and finish suit each other.
Pairings you create yourself, for products you know belong together.
Each plan covers a set number of products: 50 on Free, 250 on Starter, 1,000 on Growth and unlimited on Pro. If your store has more products than your plan allows, upgrade on the Billing page before generating recommendations. Every paid plan has a 14-day free trial; during the trial, AI matching covers your first 1,000 products and the rest are matched automatically once the trial ends.
Video guide
Watch: building your pairings
Click Regenerate All to match products using their photos, order history and product details, or Create Pairing to add your own. Regenerate All keeps the pairings you made yourself.
Watch on YouTube (opens in a new tab)Step four
Add the Complete the Set block
- In Shopify admin, go to Online Store → Themes.
- Select Customise for the theme you want to use.
- Open the Default product template.
- In the product information area, select Add block, then choose Complete the Set under Apps.
- Drag it to where you want it, usually below the product description or buy buttons.
- Save the theme.
Add the block to each product template that should show recommendations. A block added to one template does not appear on the others.
Video guide
Watch: adding Complete the Set
Click Add block to theme and the theme editor opens with Complete the Set already added. Move it, change the heading, cards per row, colours and button text, then save.
Watch on YouTube (opens in a new tab)Step five
Style it to match your store
Select the Complete the Set block in the theme editor to change its settings. Every change previews live.
Heading text and colour, accent line, section spacing, cards per row and how many recommendations to show.
Card background, corner radius, shadow, and title and price colours.
Show or hide match badges and set the label and colours for each match type.
Add to Cart button text, colours and corner radius, and the bundle button colours and text.
Step six
Set up Buy Both & Save
- In the app, open Bundle Discounts.
- In Storefront bundle offer, set the discount percentage (1 to 50) and choose whether it applies to the recommended product only or to both products. Select Save.
- In the theme editor, select the Complete the Set block and tick Enable Bundle Discount Button.
- Optionally, change the bundle button text. {percent} is replaced with your discount.
- Save the theme.
When a shopper selects the bundle button, the app creates a Shopify discount code for that pair, adds both products to the cart and applies the discount at checkout. Each code appears on the Bundle Discounts page.
Create a bundle discount for that specific pair on the Bundle Discounts page. It takes priority over your storefront default.
Video guide
Watch: setting up Buy Both & Save
Tick Enable Bundle Discount Button in the Complete the Set block, then set your discount on the Bundle Discounts page. Each pair gets its own code, and you can switch any pair off.
Watch on YouTube (opens in a new tab)Step seven
Test and measure
Once shoppers start using the section, the Analytics page shows impressions, clicks, add-to-carts and bundle adds over 7, 14 or 30 days, with your best-performing pairings.
Video guide
Watch: reading your analytics
Choose the last 7, 14 or 30 days to see impressions, clicks, add to carts and bundle adds, and which pairings get added to the cart most.
Watch on YouTube (opens in a new tab)Troubleshooting
If Complete the Set does not appear
The section stays hidden on products with no recommendations. Check the Recommendations page.
Confirm the block is in the exact product template used by the product you are viewing.
If your store has more products than your plan covers, recommendations are not generated.
It needs a paid plan, the theme setting turned on, and both products in stock.
Common questions
Visual Upsell by Amethyst FAQ
Which themes does Visual Upsell by Amethyst work with?
Complete the Set is a theme app block, so Visual Upsell by Amethyst works with Online Store 2.0 themes through the Shopify theme editor, with no theme code edits or script tags. Older or heavily customised themes may need extra theme work.
Where do Visual Upsell recommendations come from?
Visual Upsell by Amethyst combines three signals. On paid plans, AI looks at each product's photos to find items with a matching colour, style and finish. It adds products customers have bought together in past orders and your titles, descriptions, types, tags and alt text. You can also create pairings yourself.
Can I remove a recommendation I don't like?
Yes. In Visual Upsell by Amethyst, delete any pairing on the Recommendations page, and create your own with Create pairing.
What happens to sold-out products?
Visual Upsell by Amethyst keeps sold-out products in the section with a sold-out label and a link to the product page. Buy Both & Save offers only appear when both products are in stock.
Does the bundle discount stack with other discounts?
The Buy Both & Save code that Visual Upsell by Amethyst creates combines with product and shipping discounts, but not with order discounts.
Which plan do I need for bundle offers and analytics?
In Visual Upsell by Amethyst, Buy Both & Save bundles and analytics are included in every paid plan: Starter, Growth and Pro. The Free plan covers up to 50 products with the Complete the Set block and manual pairings. Every paid plan has a 14-day free trial.
Ready to complete the set?
Turn every product page into a complete set
Install Visual Upsell by Amethyst free from the Shopify App Store, generate your first pairings and add the block to your product pages.