Companion Products

Companion Products lets you attach other products to a simple product, so customers configure everything in one place before they add to cart.

Required companions force a selection before the customer can add to cart. Pick a radio button or dropdown style, set what happens when a companion is out of stock, and choose how prices display. If a customer adds 5 of the parent, 5 of the required companion go in automatically. They can add extra quantity on top of that, and the cart tracks the split: "Required: 5, Extra: 2". The required quantity is read-only in cart, and removing the parent removes the companion with it.

Add-on sections group your optional companions under named headings, in the order you choose. Each section is either checkbox mode (pick any) or radio mode (pick at most one, including none). Think "Wall Panels" and "Mounting Hardware" as separate sections on the same product, each with its own rules.

Long product names wreck layouts, so any companion can get a shorter "Display as" label that shows on the product page widget only. The real product name still appears everywhere that matters: cart, checkout, emails, and orders. A global truncation option trims long titles to one line with the full name on hover.

Incompatibility rules stop customers from picking combinations that do not work together. Mark any two add-ons as incompatible, or have a required option rule out specific add-ons. Incompatible items dim with a clear "Not compatible with" message, switching the required selection automatically removes conflicting add-ons with a polite notice, and the same rules are enforced server side, so the cart never accepts a bad combination.

A live running total shows the parent plus selected companions as the customer configures, formatted with your store currency and tax display settings. Companion thumbnails open a larger photo in a lightbox on the product page, so customers can see what they are picking without leaving the page.

Both modes add companions as separate line items with separate SKUs, so your fulfillment team sees exactly what to pick. Order lines record the section name as it was at purchase time, like "Wall Panels for [parent product]", and that label stays frozen even if you rename the section later. The plugin is HPOS-compatible and uses WooCommerce order APIs throughout. Configure it per product through the Companion Products meta box, with global controls under WooCommerce > Settings > Companion Products. Your 1.x configuration, including old conflict groups, migrates automatically on upgrade.