WooCommerce Related Products vs. Upsells and Cross-Sells

Compare WooCommerce related products, upsells, and cross-sells, then learn how to configure recommendations on product pages and in the shopping cart.

Last updated:

Reviewed for accuracy by Jesse Nickles

Choose the right recommendation type

TypeHow products are chosenTypical placement
Related productsWooCommerce selects them automatically from shared categories or tagsSingle-product page
UpsellsYou select alternatives, often upgraded versionsSingle-product page, when the layout includes them
Cross-sellsYou select complementary products to buy alongside the originalCart page, when its layout includes them

For example, a store selling coffee grinders might show other grinders as related products, recommend a premium grinder as an upsell, and suggest coffee beans as a cross-sell. Assigning an upsell does not automatically make it a related product.

Influence automatic related products

WooCommerce selects related products using categories and tags. You do not choose them individually in the Linked Products settings.

  1. Go to Products → All Products in WP Admin and edit a product.
  2. Check its Product categories and Product tags in the editor.
  3. Assign meaningful categories or tags shared with products you want shoppers to discover.
  4. Click Update, then visit the product page to check the related-products section.

Use accurate categories and tags that help customers browse your catalog. Do not add unrelated tags just to force a recommendation. WooCommerce chooses the displayed products automatically, so sharing a category or tag does not guarantee that a particular item appears or appears first.

Related products also need a section in the product template. In a block theme, the Single Product template may use an existing Related Products block or a newer Product Collection configured for Related Products. Sharing a category or tag does not guarantee that a particular item will appear first. For a fixed selection instead, choose the Hand-Picked Products collection in a compatible block layout.

Assign upsells and cross-sells

Upsells and cross-sells are selected in the product editor. Create the products you want to recommend before linking them.

  1. Go to Products → All Products and edit the product you want to promote from.
  2. In the Product data panel, open Linked Products.
  3. Under Upsells, search for alternative products, such as a higher-specification model, and select them.
  4. Under Cross-sells, select complementary products, such as accessories or supplies.
  5. Click Update to save the assignments.

To remove a recommendation, remove the selected product from its field and update the product again. These assignments work with the standard simple and variable product types. See WooCommerce's official related products, upsells, and cross-sells guide for the core settings.

Show recommendations in your product and cart layouts

Assignments alone do not create a missing recommendation section. In a block theme, check Appearance → Editor → Templates → Single Product. The template can use a Related Products block or a Product Collection set to Related Products. A Product Collection set to Upsells can display the alternatives assigned to the current product.

For cross-sells in a Cart block, edit the Cart page and open List View → Cart → Filled Cart → Cart Items. Select its Product Collection and choose Cross-Sells; set Linked Product to From products in the cart so recommendations follow the customer's cart. Older carts may still have a Cart Cross-Sells block, which continues to work. See WooCommerce's Cart block instructions.

HoverCraft uses classic WooCommerce layouts: it displays related products beneath the main product content, removes the standard upsell section, and shows up to two cross-sells beside cart totals on desktop or below the cart on smaller screens. You can still assign upsells, but HoverCraft's standard product page will not display them. See WooCommerce Product Pages and WooCommerce Cart.

Check missing or unexpected recommendations

  1. Open a product page and check whether related products share a relevant category or tag. If the layout includes upsells, look for the alternatives you assigned.
  2. Add that product to the cart and check for its cross-sells. Products already in the cart will not be suggested again.
  3. Repeat with a different product and check both product and cart pages on mobile.

If a whole recommendation section is missing, check that the product template or cart layout contains the appropriate block or classic section. If a section is present but empty, check that the suggested products are published and catalog-visible, that their stock status satisfies your store's visibility settings, and that any Product Collection filters allow them.

For unexpected related products, review categories and tags. For missing upsells or cross-sells, confirm the correct products were saved under Linked Products and that the layout displays the matching recommendation type. WooCommerce's recommendation guide covers the core behavior.