Placements control where recommendations appear on the storefront. Each placement targets a specific page and hook location, uses a selected strategy, and can be independently enabled or disabled.
Default placement
The plugin ships with a default placement that displays recommendations on single product pages, below the product tabs (the After Tabs hook). This mirrors the position of WooCommerce’s built-in related products section.
Available pages and positions
Placements can target any of these WooCommerce pages, each with multiple hook positions:
Product page
- After Add-To-Cart Button
- After Product Meta
- Before Tabs
- After Tabs
Shop page
- Before Products
- After Products
- No Products Found
Product archive (category, tag)
- Before Products
- After Products
- No Products Found
Cart
- Before Cart Table
- After Cart Table
- Cart Collaterals
- After Cart Totals
- Empty Cart
Checkout
- Before Checkout Form
- After Checkout Form
- After Place-Order Button
Order received (thank you page)
- Before Order Details
- After Order Details
- After Customer Details
Placement settings
Each placement has the following options:
- Name — A label for the placement (admin only)
- Strategy — Which recommendation strategy to use
- Location — The page and hook position
- Priority — Controls ordering relative to other content at the same hook (1–100, lower numbers render first)
- Title — The heading displayed above the recommendations on the storefront
- Recommendation Count — How many products to show (1–12)
- Excluded Categories — Categories to exclude from this placement
- Fallback Enabled — Show best-selling products when not enough relevancy matches are found
- Enabled — Turn the placement on or off
Shortcode placement
In addition to automatic hook placements, the plugin supports a shortcode for inserting recommendations anywhere:
[refinery_recommendations]The shortcode uses a dedicated shortcode placement configuration. Create a placement with the Shortcode location type to control its strategy, title, and product count.
Creating multiple placements
Multiple placements can be active at the same time. For example:
- A “Similar Products” placement on product pages using a category-heavy strategy
- A “You May Also Like” placement on the cart page using a sales-heavy strategy
- A “Recommended For You” placement on the order received page
Each placement operates independently with its own strategy, position, and display settings.