Frequently Bought Together

Last updated: January 19, 2026

Product Documentation: Frequently Bought Together (FBT) Block

Primary Use Case: Product Detail Page (PDP) Upselling

1. Executive Summary

The Frequently Bought Together (FBT) block is a high-conversion section located on the Product Detail Page (PDP). Its primary objective is to increase Average Order Value (AOV) by allowing customers to bundle complementary items and add them to their cart with a single click.

2. Implementation Strategies

Appbrew provides two primary implementation paths depending on the merchant's backend logic and promotional requirements.

A. Shopify FBT App Integration (Standard)

  • Method: Direct integration with popular third-party Shopify "Frequently Bought Together" apps.

  • Logic: Data is fetched directly from the app’s recommendation engine.

B. Metafield/MetaObject Configuration (Custom)

  • Method: Pulls product IDs or handles from specific Shopify Metafields (e.g., fbt_products).

  • Use Case: Necessary for brands using custom bundling logic or Shopify Scripts (which are often incompatible with mobile APIs).

  • Brands need to create metafield/metaobject at their end (the structure can be shared by our team) and then share a test product link where values are added in the backend.

3. Core Features & UI Specifications

Feature

Description

PDP Placement

Positioned below variants or above "Product Description" for maximum visibility.

Variant Selector

Allows users to select sizes/colors for each item in the bundle without leaving the page.

Single-Action Add-to-Cart

A "Add All to Cart" button that processes the entire bundle simultaneously.

Dynamic Item Limits

Supports up to 3+ items; configurable via the Appbrew dashboard (Ref: SUP-474).

Styling Customization

Supports brand-specific CSS/styling for borders, button colors, and fonts (Ref: Zavya Support Thread).

4. Technical Setup & Requirements

  1. Backend Access: Ensure the Shopify App or Metafields are accessible via the Storefront API.

  2. Metafield Mapping: For custom setups, the fbt_products metafield must be enabled in the Shopify Admin.

  3. App Release: Most changes to the underlying FBT logic (switching from App to Metafields) require a standard app submission/release cycle.

5. Troubleshooting & Known Issues

Symptom

Probable Cause

Resolution

"Default Title" appears

Variant names are missing or set to default in Shopify.

Update variant titles in Shopify Admin to descriptive names.

Block not visible

Metafields are empty or the third-party app is disabled.

Verify that data exists in the source (App dashboard or Metafield).

Syncing Issues

Mismatch between web-engine and mobile-engine.

Ensure both platforms are pointing to the same data source (Ref: APP-13063).