Skip to content

Locations ​

Every place a recommendation block can appear, what each spot looks like on the page, and which context it needs.

A location is a page plus a spot on that page, for example Product page · After tabs or Cart · After totals. You pick one with Position On Page, in the Setup step, right under Show On.

Two rules decide which locations you can pick:

  • The recommendation's context decides. A Cart recommendation can only go where there's a cart. Locations the context can't use stay in the list, greyed out with not available on this page, so you can see what exists.
  • A recommendation sits in exactly one location. If you want the same idea in two places, make two recommendations.

Popups are the exception. They don't have a location; they open on a trigger. See Displays.

Product page ​

Needs the Product context.

LocationWhere it landsTier
After tabsBelow the Description / Reviews tabs, where WooCommerce's own Related products sitFree
Before tabsBetween the product summary and the tabsFree
After metaBelow the summary, where WooCommerce's own up-sells sitFree
After add-to-cartDirectly below the add-to-cart button, inside the summary columnPro

Choosing between them:

  • After tabs is the "more like this" spot. Shoppers reach it after reading about the product. It's best for related products and grids to browse.
  • After meta is higher up and hard to miss. It's best for a genuine up-sell, a better version of what they're looking at.
  • After add-to-cart is the highest-intent spot on the page, because the shopper is about to buy. It's where a bundle box belongs.
  • Before tabs is a quieter alternative to After tabs, useful if your theme puts something else there.

Category and tag pages ​

Needs the Category context. Both spots work on category pages and tag pages.

LocationWhere it landsTier
Before productsAbove the product grid, below the category descriptionFree
After productsBelow the product grid, above the page numbersFree

These are useful for showing best-sellers or featured products at the top of a category a shopper has just landed on.

Cart ​

Needs the Cart context.

LocationWhere it landsTier
Before tableAbove the cart itemsFree
After totalsBelow the cart totals, where WooCommerce's own cross-sells sitFree
Empty cartOnly when the cart is emptyFree

Empty cart is the one people forget. A shopper looking at an empty cart has told you they meant to buy something. Showing best-sellers there costs nothing and beats a dead end.

Classic cart or Cart block ​

WooCommerce has two kinds of cart page. Older stores use the [woocommerce_cart] shortcode; new stores (since WooCommerce 8.3) get the Cart block. To see which you have, open Pages → Cart in WordPress: [woocommerce_cart] is the classic cart, and a blue "Cart" block is the block cart.

All three cart locations work on both, but they land in slightly different places:

LocationClassic cartCart block
Before tableAbove the cart itemsAbove the whole Cart block, when the cart has items
After totalsRight below the totalsBelow the whole Cart block, when the cart has items
Empty cartIn the empty-cart messageBelow the whole Cart block, when the cart is empty

On the Cart block, the plugin places your recommendation around the block, never inside it, because the Cart block's contents are drawn by WooCommerce itself. If you need it somewhere specific inside the cart, use the Shaped Recommend editor block instead.

Checkout Pro ​

Needs the Cart context, because at checkout the order doesn't exist yet.

LocationClassic checkoutCheckout blockTier
Before formAbove the checkout formAbove the whole Checkout blockPro
After place orderInside the order review, just below the Place order buttonBelow the whole Checkout blockPro

Both only appear when the cart has items. On the Checkout block, After place order can't sit right under the button, so it goes below the whole block. It's still the last thing the shopper sees before they leave the page.

Thank-you page Pro ​

Needs the Thank You context.

LocationWhere it landsTier
Before detailsAbove the order summary, right under the thank-you messagePro
After detailsBelow the order details tablePro

This is the highest-intent moment on the store: payment has gone through, trust is at its peak, and the shopper is still on your site. The Post-Purchase Upsell template starts here with a single-offer card.

Custom placements ​

You put these on the page yourself.

LocationHow you place itContextsTier
Custom placement · Shortcode[shapedrecommend id="123"] anywhere shortcodes runAll, including Anywhere ProFree
Custom placement · BlockThe Shaped Recommend block in the block editor or Site EditorProduct, Category, Cart, Thank YouFree

Both are covered in Shortcode & Block. Two things are worth knowing here:

  • The block is free on purpose. Block themes don't run WooCommerce's classic hooks on every page, so on those stores the block is often the most reliable way to place a recommendation.
  • A custom placement is still coordinated. The Recommendation Manager applies the same limits and the same "one product, one block" rule to it as to everything else on the page.

A recommendation with the Anywhere context Pro has only one location, the shortcode, so the builder shows you the shortcode instead of a Position On Page list.

The WooCommerce hooks behind each spot ​

This section is for theme developers and anyone working out why a block landed somewhere unexpected. Each location hangs off a standard WooCommerce action:

LocationHookPriority
Product page · After add-to-cartwoocommerce_after_add_to_cart_form10
Product page · Before tabswoocommerce_after_single_product_summary9
Product page · After tabswoocommerce_after_single_product_summary11
Product page · After metawoocommerce_after_single_product_summary15
Category / Tag · Before productswoocommerce_before_shop_loop40
Category / Tag · After productswoocommerce_after_shop_loop10
Cart · Before tablewoocommerce_before_cart10
Cart · After totalswoocommerce_after_cart10
Cart · Empty cartwoocommerce_cart_is_empty10
Checkout · Before formwoocommerce_before_checkout_form10
Checkout · After place orderwoocommerce_review_order_after_submit10
Thank-you · Before detailswoocommerce_before_thankyou10
Thank-you · After detailswoocommerce_thankyou20

The three cart locations also attach around the woocommerce/cart block, and the two checkout locations around the woocommerce/checkout block.

The product-page spots share one hook at different priorities. That's how they land either side of WooCommerce's own output: WooCommerce draws the tabs at 10, up-sells at 15 and related products at 20 on that same hook. After meta uses 15, the same slot as WooCommerce's up-sells.

If a block lands in the wrong place

Your theme has probably moved or removed WooCommerce's product-page output, which is common in heavily customised themes. Try a neighbouring location, or put the block exactly where you want it with the shortcode or editor block.

On block themes ​

The hooks in the table above belong to WooCommerce's classic page templates. A block theme builds its pages from blocks instead, and some of those hooks may not run. When a location's hook doesn't run, the recommendation simply doesn't appear. There's no error message.

Page built fromDoes it work?What to do
Classic theme templatesYes, every locationPick the location you want
Cart blockYes. The block is placed around the Cart blockSee Classic cart or Cart block
Checkout block ProYes. The block is placed around the Checkout blockSee Checkout
Order confirmation (thank-you) blockYes. WooCommerce still runs both thank-you hooksNothing to do
Block theme product or category templatesIt depends on the themeTry the location, and use the editor block if nothing shows

When in doubt, use the Shaped Recommend editor block. You place it in the editor exactly where you want it, and it's coordinated like everything else.

Not in this release ​

These are planned but not offered by the builder yet: Shop · Before products, Shop · After products and the Mini-cart panel. See Free vs Pro.

Next ​