> ## Documentation Index
> Fetch the complete documentation index at: https://help.goodnative.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Recommendations overview

> Show curated alternative products on Shopify product pages when a shopper selects a sold-out variant, so an out-of-stock visit can still end in a sale.

Recommendations turn a dead end into a sale. When a shopper selects a sold-out variant, the product page shows the alternatives you've picked under the buy buttons - *"Try this instead"*. You choose every recommendation - Bloom doesn't guess.

Recommendations were previously called **Upsells**.

## How it works

* **You curate each list.** Pick recommended products for a product, or recommended variants for a single variant - *"Sold out in M? Try L"*. See [Curate recommendations](/bloom/recommendations/product-config).
* **Variants inherit the product list.** A variant with its own list overrides the product's list for that variant only.
* **They show when stock runs out.** By default, recommendations appear when the selected variant is sold out or its pre-order is fully booked. Change this in [Recommendations settings](/bloom/recommendations/settings).
* **Only buyable picks show.** Draft, archived, unpublished and gift card products are skipped, and so are sold-out picks unless you choose to keep them. The storefront shows up to **2** at once by default.
* **Cards link to the recommended product.** Each card shows the image, title and price, and opens that product or variant.
* **Results are tracked.** Views, clicks, add to carts, checkouts and orders appear on **Recommendations → Overview**. See [Recommendations tracking](/bloom/recommendations/tracking).

<Note>
  Recommendations are off on the **Hibernate** plan. You can still curate lists - they show once you move to Starter or above. See [Plans and billing](/bloom/plans-and-billing).
</Note>

## What you need to do

1. [Add the Bloom Recommendations block](/bloom/recommendations/settings#add-the-block) to your product template (one-time setup)
2. [Curate recommendations](/bloom/recommendations/product-config) for the products that sell out
3. \[Optional] [Adjust settings, design and content](/bloom/recommendations/settings) - when they show, layout, heading
4. \[Optional] [Set up tracking](/bloom/recommendations/tracking) - GTM, GA4 and the checkout pixel

<Warning>
  Bloom can't check whether the block is on your product template. No block, no recommendations - even with lists curated.
</Warning>

## When recommendations show on the storefront

A product page must meet **all** of these conditions:

* Your plan is Starter or above
* The **Bloom Recommendations** block is on the product template
* The selected variant matches a **Display** setting - sold out and fully booked pre-order are on by default
* The product or variant has a curated list, and recommendations aren't switched off for it
* At least one pick is active, published to the Online Store and in stock - or **Sold-out recommendations** is on
* The product isn't a gift card

## Related

* [Curate recommendations](/bloom/recommendations/product-config)
* [Recommendations settings](/bloom/recommendations/settings)
* [Products CSV](/bloom/products-csv)
* [Results](/bloom/results)


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