With Link Variant a choice in an option is tied to a Shopify variant of another product: the choice takes that variant's price, the variant's inventory is reduced when the order is placed, and the linked variant appears as its own line in the cart and checkout (merged with the main product by the app's cart transform). This is how you sell a watch strap, a frame or a charm as part of a personalized product while Shopify keeps the stock.

Link Variant is available on these option types:

  • Button
  • Dropdown
  • Image Choices
  • Color Choices

The link is set on the set the option uses — an Option Set, Image Set or Color Set under Assets.

Image sets and color sets

Open Assets → Image → Image Sets (or Color → Color Sets), edit the set, and use the Variant control on each row to pick the Shopify variant for that image or color. Image sets work with both Image Choices and Color Choices options.

Assets → Images and Image Sets

v3 Add option picker with Button, Dropdown, Image Choices, Color Choices highlighted

Option sets

For Button and Dropdown options the choices come from an Option Set (Assets → Option → Option Sets); each row has a Link Variant control.

Assets → Option Sets

Picking the variant

Click Select Variant, search your products and choose the variant.

What the shopper sees

The choice's price is the linked variant's price and is added when the shopper selects it. In the cart and checkout the linked variants are listed with the product — in the screenshot below, the strap and the dial were linked variants.

Checkout with linked variants

When the order is placed, Shopify reduces the linked variant's inventory. How linked prices reach the checkout is set under Settings → Functionality → Additional pricing; see Pricing methods.

Settings → Functionality → Additional pricing

Common questions

  • Price per combination. Create the combinations as variants of a (hidden) product with the full price of each, link them to the choices, and put no Additional charge on the same choice — one price source per choice.
  • A free option. Link a $0 variant. A linked variant cannot be discounted by the app; for a different price in the bundle than sold alone, use a Shopify discount on that variant.
  • Discount one choice. Prices cannot be negative. Link the choice to a variant with the lower price, or run a Shopify discount on the linked product.
  • Why is my stock going down? The linked variant is added to the order, so Shopify deducts it — that is the point of linking. Options linked to a sold-out variant are shown as unavailable.
  • “Cart Transform function failed” at checkout. A linked variant in the cart was deleted or changed after the shopper added it (typical with abandoned carts). Keep linked variants in place while they can still be in carts; the shopper starts a new cart.
  • Price per character. Use the Per letter charge on the text option instead of linking; for tiers (1–10 letters, 11–20) offer the tiers as a Button option linked to variants and show the text field with conditions.

More questions from support

Answers our team gave to merchants who read this article and still had a question. Each is a real case, with the store details removed.

Why does the additional price show outdated until the shopper interacts?

When a Color Choices or Image Choices option links to a Shopify variant, the price is cached on page load. If you change the variant's price in Shopify, the option still shows the old price until the shopper picks a choice. Re-link the variant in the set: open the Color Choices or Image Choices field, open its set under Assets, and re-attach the Shopify variant so it reads the current price. Save and refresh the product page to confirm the updated price shows on load.

Why do linked variants show as separate line items at checkout?

Linked variants appear as separate line items because Shopify requires each variant to be a distinct cart line to track inventory correctly. The app merges or hides them on the cart page where possible, but checkout and order admin show them separately—this is a Shopify limitation outside the app's control. To use linked variants without separate line items, your store must be on Shopify Plus, which allows third-party scripts to modify checkout. Remove any fixed Additional Charge from the option when using linked variants; instead, set the price on the Shopify variant itself. If you need both a fixed price and a variant link on the same option, this is not supported—use different options within the set for each pricing method.

How do I show when a personalization option is sold out?

Sold-out display depends on how your options are set up. If the options are Shopify variants, Shopify automatically greys them out and shoppers cannot select them. If you build the options in the app (Button, Dropdown, Radio, Image Choices, Color Choices), use Link Variant to connect each choice to a Shopify variant. When a linked variant is out of stock, the app shows 'Sold out' text on that option and shoppers cannot select it. Go to the option's settings, find the choice, and set Link Variant to the corresponding Shopify variant with the quantity you want to track.

Why does the price double when I use Link Variant with the product's own variants?

Link Variant is designed to link to variants of a different product, not the same product being personalized — linking a product's own variants to itself adds the variant price on top of the base price, doubling it. Create a separate product with variants for each colour (priced at $85), then use Link Variant in your Image Set to link each colour swatch to the matching variant in that separate product. The price will then be correct, inventory stays managed in Shopify, and shoppers still see the colour swatches.

Why does Link Variant not replace the main Shopify variant in cart.js and orders?

Link Variant adds the chosen variant as a zero-price line-item property, not as the main cart line — the default variant stays as the primary line, so its SKU appears in cart.js and orders instead of the linked variant's SKU. If your ERP needs the linked variant's SKU as the main line, ask your ERP support whether it can read the linked variant from line-item properties. Otherwise, restructure the product: make size, color and other stock-affecting choices as native Shopify variants with their own SKU and price, and use Zepto only for personalization like text and colors that do not change inventory. After restructuring, the correct variant and SKU will show in cart.js and your ERP. If you need the linked variant to replace the main one in code, contact Zepto support to discuss custom development.

How do I style out-of-stock color options and avoid duplicating colors with Shopify variants?

Out-of-stock options need CSS styling, and color duplication happens when you have both Shopify variants and an app color choice field showing the same colors. First, style out-of-stock swatches by adding the .vrdisabled CSS class to Settings → Design or use custom CSS — this class is applied when a linked variant runs out of stock. Second, remove the Shopify variants from the product and keep only the app's Color Choices option to prevent duplication. Third, to track inventory and SKUs per color, use Link Variant on each color choice to link a variant from a separate Shopify product (never link a variant from the same product, as this doubles the price). If colors should not affect price, set the linked product's price to 0.

Why is my product price higher and extra items appear in the cart?

When a Color Choices option uses Link Variant, the linked variant's price is added to the product price and the linked variant product appears as a separate line in the cart and order. To fix this, open the Color Choices option, check each color's Link Variant setting and price change field, and set the price change to 0 if you don't want extra charges. If you don't want linked variants at all, use a regular Color Set instead. For sold-out messages when stock exists, check your variant quantities in Shopify's bulk edit tool.

Why does a linked variant option not show on one product?

A linked variant choice may not appear if the linked product is not published to Online Store, even if it shows as active in the admin. Open the option set, click 'open' next to each linked item, and check that the product status is Active and Online Store is selected under Sales channels and apps. Save and reload the storefront to verify the option now shows. If it still fails, contact support with collaborator access so they can check the linked items.