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.
| Location | Where it lands | Tier |
|---|---|---|
| After tabs | Below the Description / Reviews tabs, where WooCommerce's own Related products sit | Free |
| Before tabs | Between the product summary and the tabs | Free |
| After meta | Below the summary, where WooCommerce's own up-sells sit | Free |
| After add-to-cart | Directly below the add-to-cart button, inside the summary column | Pro |
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.
| Location | Where it lands | Tier |
|---|---|---|
| Before products | Above the product grid, below the category description | Free |
| After products | Below the product grid, above the page numbers | Free |
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.
| Location | Where it lands | Tier |
|---|---|---|
| Before table | Above the cart items | Free |
| After totals | Below the cart totals, where WooCommerce's own cross-sells sit | Free |
| Empty cart | Only when the cart is empty | Free |
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:
| Location | Classic cart | Cart block |
|---|---|---|
| Before table | Above the cart items | Above the whole Cart block, when the cart has items |
| After totals | Right below the totals | Below the whole Cart block, when the cart has items |
| Empty cart | In the empty-cart message | Below 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.
| Location | Classic checkout | Checkout block | Tier |
|---|---|---|---|
| Before form | Above the checkout form | Above the whole Checkout block | Pro |
| After place order | Inside the order review, just below the Place order button | Below the whole Checkout block | Pro |
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.
| Location | Where it lands | Tier |
|---|---|---|
| Before details | Above the order summary, right under the thank-you message | Pro |
| After details | Below the order details table | Pro |
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.
| Location | How you place it | Contexts | Tier |
|---|---|---|---|
| Custom placement · Shortcode | [shapedrecommend id="123"] anywhere shortcodes run | All, including Anywhere Pro | Free |
| Custom placement · Block | The Shaped Recommend block in the block editor or Site Editor | Product, Category, Cart, Thank You | Free |
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:
| Location | Hook | Priority |
|---|---|---|
| Product page · After add-to-cart | woocommerce_after_add_to_cart_form | 10 |
| Product page · Before tabs | woocommerce_after_single_product_summary | 9 |
| Product page · After tabs | woocommerce_after_single_product_summary | 11 |
| Product page · After meta | woocommerce_after_single_product_summary | 15 |
| Category / Tag · Before products | woocommerce_before_shop_loop | 40 |
| Category / Tag · After products | woocommerce_after_shop_loop | 10 |
| Cart · Before table | woocommerce_before_cart | 10 |
| Cart · After totals | woocommerce_after_cart | 10 |
| Cart · Empty cart | woocommerce_cart_is_empty | 10 |
| Checkout · Before form | woocommerce_before_checkout_form | 10 |
| Checkout · After place order | woocommerce_review_order_after_submit | 10 |
| Thank-you · Before details | woocommerce_before_thankyou | 10 |
| Thank-you · After details | woocommerce_thankyou | 20 |
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 from | Does it work? | What to do |
|---|---|---|
| Classic theme templates | Yes, every location | Pick the location you want |
| Cart block | Yes. The block is placed around the Cart block | See Classic cart or Cart block |
| Checkout block Pro | Yes. The block is placed around the Checkout block | See Checkout |
| Order confirmation (thank-you) block | Yes. WooCommerce still runs both thank-you hooks | Nothing to do |
| Block theme product or category templates | It depends on the theme | Try 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
- Displays: what the block looks like once it's placed.
- Hiding WooCommerce's Own Sections: switching off WooCommerce's built-in related products, up-sells and cross-sells.
- Shortcode & Block