Skip to main content
Frequently Bought Together (FBT) widgets display product recommendations on your product pages, allowing customers to add complementary items to their cart with one click.

What is an FBT Bundle?

An FBT Bundle shows the current product plus 1-3 recommended items. Shoppers can select variants for each recommended item, see the total price, and add everything to cart together. An optional discount applies automatically when all items are purchased together. Example: On a laptop product page, show “Frequently Bought Together” with a laptop case, wireless mouse, and USB hub. Shoppers select their preferred variants and add all items to cart with 10% off.

When to use FBT Bundles

FBT Bundles work best for:
  • Cross-selling complementary products: Accessories, add-ons, or items that pair well
  • Increasing average order value: Encourage customers to buy more in one transaction
  • Reducing decision fatigue: Pre-select smart recommendations for shoppers
  • Product discovery: Surface items customers might not have found otherwise

How FBT Bundles Work

  1. Shopper views product page where FBT bundle is active
  2. Widget displays recommendations (1-3 items) with checkboxes and variant selectors
  3. Shopper selects items and variants they want to add
  4. Clicks “Add selected to cart” - all items added in one action
  5. Optional discount applies automatically at checkout when all FBT items are in cart
  6. Inventory decrements for the actual products purchased

Creating an FBT Bundle

1

Create the bundle

Go to Bundles → Create Bundle → Frequently Bought Together
2

Set basic info

  • Internal name: For your reference (e.g., “Laptop Accessories FBT”)
  • Widget title: Shown to customers (e.g., “Frequently Bought Together”)
  • Button text: CTA text (default: “Add selected to cart”)
  • Max Items: Choose 1-3 recommended items
3

Choose recommendation source

Pick how recommendations are generated:
  • Automatic (Recommended): Shopify suggests complementary products automatically. Fastest setup. Optionally pick Show on these product pages; leave empty to show the widget on every product page.
  • Global: Show the same products on every product page (or specific collections)
  • Manual: You pick the product pages the widget appears on, and the exact products to recommend
Frequently bought together editor with Recommendation Source set to Manual
4

Set optional discount

Choose whether to offer a discount when all FBT items are purchased together:
  • No discount: Recommendations only, no price incentive
  • Percentage off: E.g., 10% off when all items added
  • Fixed amount off: E.g., $15 off bundle
The discount applies only when all FBT items are in cart, through Shopify Functions at checkout.
5

Set status and save

  • Active: Widget appears on product pages immediately
  • Paused: Bundle saved but not shown to customers
Select Save in the save bar.

Recommendation sources

Automatic

Shopify analyzes your product catalog and suggests complementary items using its built-in recommendation engine. The algorithm considers:
  • Product type, tags, and collections
  • Purchase patterns (if available)
  • Product attributes
Best for: Fast setup, no manual work. Shopify keeps recommendations fresh automatically. Limitations: Requires sufficient product data. New stores or products may see fewer recommendations initially.

Global

Show the same recommended products on every product page (or only on products in specific collections). Best for:
  • Bestsellers you want to promote everywhere
  • Universal accessories (e.g., gift wrap, care kits)
  • Cross-category bundles
How to configure:
  1. Select Global as recommendation source
  2. Click Select products and pick the products in the Shopify picker
  3. Optionally, click Select collections to show the widget only on products in those collections

Manual

You choose exact products to recommend. Manual recommendations override Automatic and Global for the products they’re set on. Best for:
  • Curated bundles with specific pairings
  • Seasonal promotions
  • High-touch merchandising
How to configure:
  1. Select Manual as recommendation source
  2. Click Select product pages and pick the products whose pages should show the widget
  3. Click Select products and pick the recommended items in the Shopify picker

Adding the Widget to Your Theme

The FBT widget is part of the Bundles (product page) app block, the same block that shows your other bundles on product pages. If the block is already on your product template, you don’t need to add it again.
The quickest way is the Add Bundles (product page) button in the setup guide on the Appfox Home page. It opens the theme editor on your product template with the Bundles (product page) block ready to add. Click Save.
To add it yourself:
1

Open the theme editor

Go to Online Store → Themes in Shopify admin, then click Customize.
2

Add the app block

In the theme editor:
  1. Select a product page template (usually Default product)
  2. Click Add block in the product information section
  3. Choose Bundles (product page) under Apps
3

Position the widget

Drag the app block to your preferred location (e.g., below product description or above “Add to Cart”).
4

Save

Select Save in the save bar.
If your store uses more than one product template, add the block to each template whose products should show the widget.
The FBT widget only appears on products that have active FBT bundles configured, and only when at least one recommended product can be sold on your Online Store.

Cart page

The FBT widget appears on product pages only. The cart drawer and cart page upsells (Cart drawer offers and Cart page offers) suggest products that complete your other bundle types; they don’t show FBT recommendations.

Styling and Customization

Customize widget appearance in Settings → Customize Appearance. All bundle widgets share the same styling controls:
  • Colors: Background, text, buttons, borders
  • Typography: Font family, sizes, weights
  • Spacing: Padding, margins, gaps
  • Custom CSS: Advanced styling overrides

Discounts and Pricing

How discounts work

When you configure a discount:
  1. Shoppers see the discount offer in the FBT widget
  2. Items are added to cart with _appfox_fbt_bundle_id property
  3. At checkout, Shopify Functions detect all FBT items in cart
  4. Discount applies automatically if all items are present
  5. Discount applies exactly once per FBT bundle (not stacked)

Discount types

  • Percentage: E.g., 15% off. Applies proportionally to each item
  • Fixed amount: E.g., $20 off. Distributes proportionally across items based on price

Important notes

  • Discounts stack with other non-FBT discounts (e.g., product-level discounts)
  • FBT discount does NOT stack with other bundle discounts from this app
  • If customer removes an FBT item from cart, discount no longer applies

Star ratings (optional)

Frequently bought together widget with 4.7 (12) next to Blue Snowboard
If you connect Judge.me or Loox in Settings → Integrations, star ratings appear next to the product being viewed and each recommended product in the FBT widget. This helps build trust and encourage clicks on recommended items. If both apps are connected, choose one source under Star ratings source.

Analytics

Track FBT performance in the Analytics dashboard:
  • Impressions: How many times the FBT widget was viewed
  • Add-to-cart clicks: How many times “Add selected to cart” was clicked
  • Revenue: Total revenue from FBT bundles
  • Conversion rate: Impressions to add-to-cart ratio

Troubleshooting

Widget doesn’t appear

  • Check that the bundle status is Active
  • Verify the Bundles (product page) app block is added to your product template in the theme editor
  • Check that the recommended products are active and published to your Online Store sales channel. Products the storefront can’t sell are left out, and with none left the widget stays hidden
  • Ensure the product has an active FBT bundle configured
  • For Global: confirm the recommended products (and optional collections) are correct
  • For Manual: confirm you picked Show on these product pages (the pages the widget appears on) and Recommended products
  • To change them, open the bundle from Bundles and click the edit icon

No recommendations shown (Automatic)

  • Automatic uses Shopify’s own product recommendations: complementary products you set in the Shopify Search & Discovery app first, then related products Shopify picks
  • Shopify’s recommendation engine requires sufficient product data
  • New products may take time to generate recommendations
  • Try switching to Global or Manual source temporarily

Discount not applying

  • Verify all FBT items are in cart with correct properties
  • Check that discount function is deployed: shopify app deploy
  • Ensure discount is configured in bundle settings
  • For Automatic: Recommendations are determined by Shopify’s algorithm
  • Switch to Global or Manual for full control over recommendations

Best practices

  1. Start with Automatic for fastest setup and ongoing optimization
  2. Use clear, benefit-driven titles: “Complete Your Setup” vs “Frequently Bought Together”
  3. Show 2-3 items for best results (1 item is too limiting, 3+ is overwhelming)
  4. Test discount amounts: 10-15% is a sweet spot for most stores
  5. Monitor analytics: Check conversion rates and adjust recommendation source if needed
  6. Match your brand: Customize widget styling to fit your store’s design
Need help? Contact us at support@getappfox.com.