Skip to content
WooCommerce & WordPress Plugin Docs

Pair Pro

Pair Pro is the premium edition for Pair. It is an add-on that requires the free Pair plugin installed and active; it is distributed through Freemius (licensing, activation and automatic updates), not the WordPress.org directory.

Pair Pro extends the free recommendation blocks with the one type shoppers respond to most: Frequently bought together, computed from what your customers actually buy in the same order. It does not work on its own. If the free plugin is missing, deactivated, or older than the required version, Pair Pro stays dormant and shows an admin notice instead of booting.

Shipping PRO features

Section titled “Shipping PRO features”
  • Frequently bought together: a block on the single product page listing the products most often purchased in the same order as the one being viewed. CoPurchaseRepository scans your most recent completed and processing orders (a bounded, cached scan) and counts co-purchases, so suggestions reflect genuine buying behaviour instead of category guesses. Renders just above the free “You may also like” block using your theme’s product cards.
  • One-click “Add all to cart”: an optional button that adds the whole bought-together set to the cart in a single request. Plain POST form with a nonce, no frontend JavaScript; only purchasable, in-stock products are added.
  • Settings page: a WooCommerce > Pair Pro screen with enable/disable, the heading and its Show this heading switch, product count (1-6), columns, in-stock-only filter, the add-all button and how many recent orders to analyse.
  • Bundle discount (bundle_discount): an optional “buy the whole set, save X%”. When the shopper uses add-all-to-cart, the set’s product IDs are recorded in the WooCommerce session and the discount applies as a negative cart fee for as long as every product in the set stays in the cart.
  • Manual curation (manual_enabled, manual_mode): hand-pick the recommendations for a specific product. The selection is stored in the _pair_manual_recommendations post meta and merged in through the free plugin’s pair/recommendations filter, either leading or replacing the automatic picks.
  • Category rules (rules_enabled, category_rules): “when a product is in category A, recommend products from category B”, defined globally and applied to the single-product placement.
  • Extra placements (place_thankyou, place_checkout): the same recommendation block on the order-received page and at checkout, rendered with the free plugin’s markup so styling and analytics apply.
  • Editor block: a dynamic “Pair Recommendations” block for the block editor and FSE templates, server-rendered from the free recommender.
  • A/B testing (ab_enabled, ab_strategy_b): each visitor is assigned a sticky cookie variant. A keeps the default product-page recommendations, B swaps in an alternative strategy, and the analytics screen reports the two side by side.
  • Recommendation analytics (analytics_enabled): impressions and clicks on the storefront blocks, with an add-to-cart attributed when a clicked product is later added. Attribution is click-based and approximate, a directional signal rather than exact revenue accounting.

How the data is mined

Section titled “How the data is mined”

On the first view of a product, Pair Pro fetches the most recent paid orders (completed and processing, 150 by default, configurable from 20 to 1000), keeps the orders that contain the product being viewed, and tallies the other products bought alongside it. Variations collapse into their parent product so one product appears once. The ranked list is cached in a transient for 12 hours per product, so the order scan runs at most once per cache window.

Orders are read through the WooCommerce order API (wc_get_orders), which is HPOS-safe.

Install and verify

Section titled “Install and verify”

Pair Pro ships with useful defaults: the block enabled, three products, three columns, in-stock products only, the add-all button on and 150 recent orders analysed. Once the free plugin is active and your store has order history, the block appears without further setup.

Install

Section titled “Install”
  1. Install WooCommerce and make sure it is active.
  2. Install and activate the free Pair plugin (0.1.0 or later).
  3. Upload the plogins-pair-pro folder to /wp-content/plugins/, or install the Freemius-provided zip from Plugins > Add New > Upload Plugin.
  4. Activate Pair Pro through the Plugins screen and complete the Freemius license activation when prompted.
  5. Open WooCommerce > Pair Pro.

Verify the block

Section titled “Verify the block”

Open a product that appears in recent orders together with other products. The Frequently bought together block renders after the product summary, just above the free “You may also like” block, using the theme’s normal product cards.

If the block does not appear:

  • The store may have no completed or processing orders that contain this product alongside others. The block hides itself when there is no co-purchase data.
  • In stock only is on by default; co-purchased products that are out of stock are filtered out.
  • Results are cached for 12 hours per product, so new orders show up after the cache window passes.

Test add all to cart

Section titled “Test add all to cart”

With Add all to cart enabled (the default), the block ends with a single button. Click it: every purchasable, in-stock product from the block is added to the cart in one request and you are redirected back with the usual WooCommerce added-to-cart message. The button is a plain form post, so it works without JavaScript.

Tune the block

Section titled “Tune the block”

On WooCommerce > Pair Pro:

  • Products controls how many co-purchased products to show, from 1 to 6.
  • Columns controls the grid, from 1 to 6.
  • Orders to analyse controls how many recent paid orders are scanned, from 20 to 1000. Higher values give more signal on large stores at the cost of a heavier scan on cache miss.

Start with the default 3 products. The block sits above the free recommendations, so a small, confident set converts better than a long grid.

Configuration

Section titled “Configuration”
Screen Purpose
WooCommerce > Pair recommendations Free blocks: product-page, cart and recently viewed recommendations.
WooCommerce > Pair Pro Frequently bought together: enable, heading plus its show switch, count, columns, add-all button, in-stock filter and order scan depth. Also the placement heading and its own show switch.

Requirements

Section titled “Requirements”
  • WordPress 6.4 or later
  • PHP 8.1 or later
  • WooCommerce 8.0 or later
  • The free Pair plugin, version 0.1.0 or later, installed and active

Pricing

Section titled “Pricing”

Pair Pro is sold through Freemius with annual licenses: EUR 29 for 1 site, EUR 59 for 5 sites, EUR 99 for unlimited sites. The license covers updates and support for the term.

Relationship with Pair

Section titled “Relationship with Pair”

The free plugin covers automatic “You may also like” and cart cross-sell blocks based on shared categories and tags, plus recently viewed products. PRO adds order-history co-purchase recommendations with a one-click add-all-to-cart button. The PRO block reuses the free plugin’s markup and stylesheet, so both blocks inherit the same theme product cards.

Next steps

Section titled “Next steps”
  • Configuration, every setting on the Pair Pro screen.
  • FAQ, common questions about data, caching and licensing.