Configurable Products

Some promotional products are not a single item with a list of colors. They are built from more than one part: a plush bear that ships with a printed shirt, a tumbler that comes with a color-matched straw, or a new-hire kit that bundles a notebook, pen, mug, and pouch. Suppliers describe these as multiple part groups in their pricing and configuration data.

When Configurable Products is enabled, PromoSync reads those part groups and builds the real variant matrix as one Shopify product. When it is disabled, these products import the old way: every part is flattened into a single option list, which produces confusing variants (for example, a $0.00 bear color and a separately priced shirt that has no bear attached).

Enabling Configurable Products

Configurable Products is an admin feature flag and is off by default.

You can turn it on from Shop Settings, in the import settings card, by checking Enable Configurable Products. Once enabled, the next import (or re-import) of a multi-part product builds the variant matrix automatically.

How variants are built

Each part group that represents a real choice becomes a Shopify option, and every sellable variant is a combination of one selection from each option. Parts that are not a real choice (a single fixed component, or an accessory that is locked to another part’s color) are attached to the variant automatically.

Option names and values

• Option names use the supplier’s group label when there is one (for example Sunglasses). When the supplier only provides a generic label, the option is named Option 1, Option 2, and so on. You can rename options in Shopify after import.
• Option values are kept unique. When one option mixes item types (shirts, hoodies, and bandanas that all include a “Navy Blue”), the values are labeled to stay distinct, for example Shirt - Navy Blue and Hoodie - Navy Blue.

Pricing

The price of a configurable variant comes from the priced part of the combination, with your store’s normal pricing rules applied (MQ, MAP, MDP, or a custom strategy).

In most kits one part carries the price and the rest are included:

• For the plush bear, the apparel carries the price and the bear is included, so a “Brown bear + Athletic Gold shirt” variant is priced from the shirt.
• For the tumbler, the body carries the price and the straw is included.
• For a kit, the anchor item carries the price and the other pieces are included.

Volume and tier pricing work exactly as they do for any other product: the variant’s price breaks come from its priced part.

Inventory

Each variant tracks inventory based on its priced part. Because a configurable product can reuse the same component across several variants (for example the same shirt color paired with two different bear colors), review inventory after import to confirm it reflects how you actually fulfill the product.

Images

PromoSync assigns each variant the best matching image it can find for that variant’s parts:

1. An exact match on the part.
2. A match on the shared color code when the supplier’s image is keyed slightly differently from the variant (for example a recycled body 5306RBLK matched to the supplier’s 5306BLK blank image).
3. The product’s general image, so no variant is ever left without a picture.

Some suppliers only publish general or grouped marketing images for these products. In that case the matching above does its best, but per-color images are limited by what the supplier provides.

SKUs

A configurable variant’s SKU lists every component, joined with a hyphen, so the full bill of materials is visible on the variant. For example:

• 1200BRN-1210BLK (brown bear with a black shirt)
• 5306RBLK-5306RBLKSTRAW (black tumbler with its matching straw)

This makes it clear which supplier parts make up each sellable variant when you place purchase orders.

Related

• Product Import Settings
• Pricing Configuration
• Volume Pricing