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

# Frequently Bought Together (FBT)

> Show Shopify Frequently Bought Together picks in Appfox, using automatic, global, or manual products, an optional checkout discount, and Judge.me or Loox stars.

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](https://mintcdn.com/appfox-bundles/JvgX2FNik22wHOl8/product-bundles/docs/images/17-bundle-edit-fbt.png?fit=max\&auto=format\&n=JvgX2FNik22wHOl8\&q=85\&s=cbd1e7c026e8d63ebec47f1e2f7048cb)

**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.

> [!TIP]
>
> 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.

> [!TIP]
>
> 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](https://mintcdn.com/appfox-bundles/JvgX2FNik22wHOl8/product-bundles/docs/images/45-fbt-star-ratings.png?fit=max\&auto=format\&n=JvgX2FNik22wHOl8\&q=85\&s=aeb7da4f75bcee49095f70297dc99b13)

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

### Wrong products recommended

* 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

> [!TIP]
>
> Need help? Contact us at [support@getappfox.com](mailto:support@getappfox.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.