Skip to content

Glossary ​

Plain-English definitions of the terms this plugin uses with a precise meaning, plus the WooCommerce and WordPress words that come up alongside them.

Shaped Recommend terms ​

Active / Inactive A Recommendation's status, shown on All Recommendations. Only Active ones render on your storefront. Click the switch in the list to change it. There's no draft status: a new Recommendation goes Active when you save it, unless it isn't complete enough, in which case it's saved as Inactive and you're told what to fix.

Additional Filters The switch that lets you add your own filters on top of the automatic pool. With Filter Type on auto, the filters you add narrow the automatic pool rather than replacing it.

Attribution Connecting revenue back to the Recommendation that earned it. A shopper clicks a product in a block, then completes an order containing it within 48 hours, and that revenue is attributed to the Recommendation.

Auto mode The default Filter Type. The page the block is on decides the pool: Same Category & Tags on a product page, From This Category & Tags on a category page, Pairs With The Cart in the cart, Complements The Order on the thank-you page Pro, and Best-sellers for Anywhere Pro. The alternative is Choose Specific Filters.

Beacon The small request the storefront sends to record that a block was viewed or a product was clicked.

Candidate A product that might appear in a block, before filters, sorting and coordination have had their say.

Cap / limit A limit the Recommendation Manager can enforce: blocks per page, or recommendations per shopper visit. Both are off by default. Separately, no block ever shows more than 20 products.

Context (Show On) The kind of page a Recommendation is for, and so what it can read: the product being viewed, the category, the cart, the completed order, or nothing in particular. The builder calls it Show On, with the options Product, Category, Cart, Thank You Pro and Anywhere Pro. It decides which positions are available.

Deduplication (dedupe) Not showing the same product twice on one page. Turned on with No repeated products under Settings → Recommendation Manager. Off by default. It works within one page, not across a shopper's visit.

Deployment The developer term for a placement: a Recommendation's position, display, conditions and display settings.

Display style How a block looks: Grid, Inline list, Bundle box Pro, Single-offer card Pro or Popup Pro. It never changes which products appear.

Display condition See visibility condition.

Filter A rule deciding which products qualify to appear inside a block. Compare visibility condition.

Fires On For a popup Pro, the pages it's allowed to open on, such as Checkout or Product pages. A popup has a trigger and Fires On pages instead of a position on the page.

Hydration The step where a placeholder on the page fills in with real products, from one batched request per page. It's what makes recommendations work behind a page cache.

Limit reached A chip on All Recommendations meaning an Active Recommendation was recently held back by the blocks-per-page or recommendations-per-session limit. It reflects what actually happened on the storefront, not something you set.

Live Preview The right-hand pane in the builder. It runs the same engine as the storefront, against an example product, category or cart from your own store, and tells you when a block would render nothing and why.

Location / Position On Page Where on the site a block appears, written as Page · Slot, for example Product page · After tabs. Set under Position On Page in Step 1.

Pinned product A product you force to appear first. Pinned products skip the filters, but never the block's product limit.

Placement One appearance of a Recommendation: where it sits (or, for a popup, when it opens), how it looks, and its display conditions. Each Recommendation has one placement.

Plan The list of approved blocks the Recommendation Manager produces for one page view. Every block on the page renders its part of the same plan.

Priority order Which Recommendation wins when two want the same position. On the free plugin, the one created first wins. With Pro Pro, you set the order by dragging rows on All Recommendations.

Recommendation One saved set of instructions: what page it's for, how products are chosen, its filters, sorting, pinned products and placement.

Recommendation Manager The part of the plugin that decides which blocks actually show for a shopper on a page: winner per position, limits, deduplication, and dropping empty blocks. Its settings are a tab under Settings.

Selection method (How Products Are Chosen) How candidates are found: Rules (Default), where you set filters and sorting, or Store Statistics Pro, mined from your orders. Developers may see it called a signal.

Session (visit) One shopper visit. It ends after 30 minutes without activity. The recommendations per session limit counts within it.

Snapshot The published copy of everything the storefront needs, rebuilt whenever you save. The storefront reads the snapshot, never your work in progress.

Sorting rule A rule that decides the order matching products appear in, such as Popularity or Price. Several rules are blended into one order, each counting the same. With no rules, products come back in random order on every page view.

Store Statistics Pro The selection method that mines your completed orders for products that are genuinely bought together. Until there's enough history, it falls back to category and popularity.

Suppression The Recommendation Manager deciding a block won't render. It's always logged with a reason and never shown to the shopper as an error or an empty box.

Trigger Pro What opens a popup: On Page Load, On Exit Intent, On Add To Cart or When Cart Value Reached.

Visibility condition (display condition) A rule on Step 3 · Display Conditions deciding whether the block appears at all: Device, plus Cart Total, Visitor, Schedule and Viewing Category Pro. Compare filter.

WooCommerce Default Showcase The switches under Settings → General that hide WooCommerce's own Related products, Up-sells or Cross-sells. They hide them on every page, regardless of whether your own block shows there.

Winner selection Choosing between two Recommendations that want the same position. Decided by the priority order.

WooCommerce terms ​

Cross-sells Products WooCommerce shows in the cart, picked by hand on each product's Linked Products tab.

HPOS (High-Performance Order Storage) WooCommerce's newer way of storing orders. Shaped Recommend supports it; leave it on.

Product type Simple, variable, grouped or external. The bundle box adds every item with one click, so it only includes simple products. A variable product needs options chosen first.

Related products The section WooCommerce shows under the product tabs, picked from products sharing a category or tag, then shuffled.

Up-sells Products WooCommerce shows on a product page, picked by hand on that product's Linked Products tab.

Variation One specific combination of a variable product's options, such as "Blue, Large". Store Statistics counts variations as their parent product.

WordPress terms ​

Action Scheduler The background job runner that ships with WooCommerce. Nightly analytics rollups and order mining run through it, never during a page view.

Block theme A theme built entirely from blocks and edited in the Site Editor. It may not fire WooCommerce's classic PHP hooks, which is why the Shaped Recommend block is free.

Capability A permission. This plugin adds sprcm_manage_recommendations and sprcm_view_analytics, both given to Administrator and Shop manager. A few store-wide destructive actions also need manage_options, which normally only Administrators have.

Classic theme A theme built from PHP templates. It fires the WooCommerce hooks that the standard positions attach to.

Custom post type How WordPress stores structured records. Each Recommendation is one.

Hook A named point in the page where a plugin can add output. The location map lists the ones this plugin uses.

REST API The /wp-json/ interface. The admin screens and the storefront's fill-in request both use it. Reference.

Shortcode A bracketed tag that WordPress replaces with content. Here, it's [shapedrecommend id="123"].

Site Editor Where block themes are edited. The Shaped Recommend block works there.

WP-Cron WordPress's scheduler, which Action Scheduler relies on unless your host runs a real server cron. If it stops, analytics rollups and order mining stop too.

Next ​