OxifyOxify
Frequently Bought Together (FBT)

FBT placement rules

Where FBT bundles render and how to control placement.

This article is a draft and may be incomplete or change before publishing.

Product page (PDP)

FBT bundles render on product pages only. By default the offer sits directly below your theme's Add to cart button. This is where all FBT impressions and conversions happen. (Cross-sell offers are also placed below the button; Product add-on offers are placed above it.)

Two things need to be in place:

  • The Oxify: Product Upsell app embed is on in your theme. When it isn't, the Product Page Upsell page shows an Activate FBT Upsell App Embed banner with an Activate button.
  • The offer is Active and its Trigger matches the product (see Which offer shows below).

Position it yourself

The Placement tab of an offer (Product Page Upsell → your offer → Placement) shows a snippet for that offer type, with a Copy button. There are two ways to choose the spot:

  1. App block — in the theme editor, open a product page template and add the Oxify: Bought Together app block where you want the bundle. (Oxify: Cross-sell and Oxify: Product Add-ons are the matching blocks for the other offer types.)
  2. Snippet — paste the snippet into your product page template where the bundle should appear:
<div id="oxify-fbt-fbt-block"></div>

When the block or the snippet is on the page, the offer renders there instead of below the button.

Which offer shows

A product page shows at most one offer of each type — one Frequently bought together, one Cross-sell and one Product add-on. When several Active offers of the same type match a product, the most specific trigger wins: Specific products, then Products in specific collections, then All products. If two have the same trigger type, the most recently updated one wins. A lower-priority offer doesn't step in when the winner can't be shown (for example, it has no products picked).

Not available

FBT offers don't render in the cart drawer or on collection pages. For in-cart suggestions, use the cart editor's Upsells.

Start with the default placement. Add the app block or snippet only if the bundle lands in the wrong spot or can't be placed — see Troubleshooting: FBT not appearing on product page.

On this page