# Connect a CBX product to a Magento product

> Attach a CBX product to a Magento catalog product so the configurator appears on its product page.

Source: CBX documentation, version 4.0 preview (unreleased). Canonical page: https://docs.configbox.at/docs/4.0-preview/admin-guide/magento2/connect-a-magento-product. Last updated 2026-08-01.

---
> **Audience:** store admins on Magento 2 · **Scope:** making one Magento catalog product configurable · **Last reviewed:** 2026-07-25

**What this does** — Puts the CBX configurator on a Magento product's storefront page. The
customer configures right on the product page and adds the result to the normal Magento cart.

## Before you start

- Build the CBX product first — pages, questions, answers, rules, prices — in
  **Configbox → Administration → Products** (see
  [Products & configurator](https://docs.configbox.at/docs/4.0-preview/admin-guide/products/)). You can refine it later; the link doesn't
  need rebuilding after changes.
- Have the Magento catalog product ready (or create it now) — a simple product is the usual
  choice. Its Magento price is what a customer pays *without* configuring; the configured price
  replaces it in the cart.

## Steps

1. In the Magento admin, open **Catalog → Products** and edit the product.
2. Scroll to **Customizable Options** and click **Add Option**.
3. Set the new option's type to **CBX Configuration** (in the **Rovexo** group of the
   type dropdown).
4. In the **Select Configbox Product to Associate** dropdown that appears, pick the CBX
   product to attach.
5. **Save** the product.

![A product's custom option of type CBX Configuration](img/magento-product-custom-option.jpeg)

## What happens next

The configurator renders automatically on that product's storefront page — the questions in the
product-options area, the visual preview in the image/gallery area. There is nothing to place,
no widget and no page edit: the custom option is the only attachment point, and it is enough.

![The storefront product page with the CBX configurator in the product-options area and the visual preview in the gallery](img/magento-storefront-configurator.jpeg)

The price above the questions is the CBX-calculated total, updated live as the customer
chooses; **Add to Cart** is Magento's own button, unchanged.

## Good to know

- **One CBX configuration per Magento product.** The link supports exactly one CBX
  product; adding a second CBX-type option is not supported and silently keeps only one.
  To offer two configurable products, use two Magento products.
- **Duplicating the Magento product keeps the link** — the copy points at the same CBX
  product.
- **Prices and tax follow Magento.** The configured price is calculated by CBX but taxed
  by the Magento product's tax class, so the storefront price display matches the rest of your
  store.
- **The same CBX product can be attached to several Magento products** — for example one
  configurator behind several catalog entries per store view.

## Troubleshooting

- **No "CBX Configuration" type in the dropdown** — the CBX module isn't (fully)
  installed on this Magento instance; ask whoever maintains the site.
- **The configurator doesn't appear on the product page** — check the option was saved with a
  CBX product selected, and that the CBX product is published
  (see [add a product](https://docs.configbox.at/docs/4.0-preview/admin-guide/products/add-a-product)).