Troubleshooting
3D Bits would rather stop a sale than let a shopper be charged the wrong amount. That is the right trade, but it means a shopper occasionally sees a message. This page turns each one into an action.
Messages a shopper might see
What a shopper can be told lists the messages that are not about a configured price: stock, the cart and a dropped connection.
"…is made to order and has to be configured on its product page"
What happened. The product reached the cart without going through the configurator - so there is no configuration to price it from.
Usual causes, in order of likelihood:
- A quick-add button on a collection, search or home page
- An accelerated checkout button, such as Shop Pay or Apple Pay, left showing on the product page: they add the product without its configuration, and checkout refuses it
- A direct cart link, or a "buy it again" flow
- A cart that has been sitting since before you published pricing
- The configurator failed to load on that pageview
What to do. Ask the shopper to remove it and add it from the product page. Then prevent it happening again: turn off quick-add for your configured products in the theme editor, and check any app that adds to cart from outside the product page. If the product page shows accelerated checkout buttons, set Theme product controls in the project's Storefront settings back to Smart - hide what the configurator replaces (recommended) and press Save settings, or a block's Theme buy buttons to Auto (recommended) - see Theme buy buttons.
"The configured price for … is out of date"
What happened. The configuration in the cart no longer matches your current pricing, or the cart was edited after the item was added and no longer pays for every item it holds.
What to do.
- Open the project. If your projects list marks it Republish needed and the Pricing catalog card shows a Price changed badge, checkout refuses that product at its new price until you publish: press Update prices and publish - see Linked products.
- If the project page says Helper products were edited in Shopify, a helper product's price was changed in Shopify. Publish again to put your prices back, and change prices in the Composer only - see Helper products.
- If everything looks healthy, the cart is simply older than your last publish. Ask the shopper to remove the item and configure it again. Until it is removed, Shopify refuses every other item added to that cart too, with the same message naming that product.
- If it happens only to shoppers in one country and the project does not charge through Product lines, that country may be in a market that includes tax based on the shopper's country - see Tax that depends on the shopper's country.
- If your store is in the United States and it happens to shoppers there, check Include sales tax in product price and shipping rate under Settings, Taxes and duties in Shopify - see Stores in the United States that include tax in prices.
"The extras for … no longer match its quantity"
What happened. The configured item reached the cart without the right extras. With Product lines charging, the usual cause is that it was added with your theme's own Add to cart instead of the configurator's, which adds the product without the lines its choices are charged through. It also happens when the cart was edited after the item was added: the quantity was changed on the cart page, or part of it was removed.
What to do. Ask the shopper to remove the item and configure it again, then add it with the configurator's own Add to cart. If your panel has no Add to cart element, or hides it on some devices, publishing warns you: add one, show it on every device, and publish. Changing the quantity on the cart page does not change the extras: to buy several, the shopper chooses how many in the configurator before adding to cart. Give your panel a Quantity element, or tick Show quantity stepper on its Add to cart, so they can.
"The price of … in your cart no longer matches its configuration"
What happened. The cart charges more than the configuration costs. Usually the quantity was lowered on the cart page after the item was added, which leaves part of the price behind for the items taken away. It also happens when a helper product, or a linked product in a project marked Republish needed, costs more in Shopify than when you last published, and in a market that includes tax based on the shopper's country, for a shopper whose country's tax rate is higher than yours.
What to do. Ask the shopper to remove the item and configure it again. If a product's price changed, publish the project again. If shoppers in one country keep seeing it and the project does not charge through Product lines, see Tax that depends on the shopper's country.
"This option is temporarily unavailable"
What happened. Something the configuration needs cannot be bought right now. Most often it is a linked product that has been deleted, archived, taken out of the Online Store channel, or sold out with nothing to stand in for it. It can also be a helper product taken off the Online Store or repriced in Shopify, or, in a project marked Republish needed, a linked product repriced in Shopify.
What to do. Open the project. The Pricing catalog card shows Link broken, Not purchasable, Out of stock or Price changed against the culprit, or a banner says Helper products were edited in Shopify or Helper products are not on the Online Store, and says what to do. Treat this as urgent: while it lasts, no configuration that needs it can be sold.
When only a company buyer sees it. If the shopper is logged in for a company on Shopify B2B and other shoppers can add the same configuration, a product the configuration needs is missing from that company's catalog: a linked product, a product a part picks from, or a helper product. Add it to the catalog - see B2B and dealers.
"We couldn't confirm the price for …"
What happened. The price is not known to be wrong, but it could not be confirmed, so the sale stopped. Usually the project was unpublished, or republished with pricing switched off, while that item sat in a cart.
What to do. Check the project is still published with pricing on. Then ask the shopper to reconfigure.
"The configuration for … is incomplete or invalid"
What happened. The item reached the cart with a required field empty, a value failing a rule you set, or a value the configurator does not offer. An item added before your last publish can be refused the same way when that publish removed a choice it uses or narrowed a range. While such an item stays in the cart, nothing else can be added either.
What to do. Ask the shopper to remove the item and configure it again on the product page. If it recurs, check your required fields and validation rules are reachable in the layout - a required control hidden inside a collapsed section is easy to miss.
"We could not work out the price for this configuration right now"
What happened. This message comes only with Product lines charging. The configuration costs less than the cart would have to collect for it, so the add was refused rather than charged at the wrong amount: an option or a part charges less than the products it adds to the cart.
What to do. This should rarely reach a shopper, as publishing refuses to go live when it finds a configuration that costs less than what it adds. Publish the project again: it either succeeds, or stops and names the selections and how much to raise the options chosen there. Raising the base price does not help in Product lines: the base price is your product's price in Shopify, so the two rise together and the gap stays. See Linked products.
If the shopper ordered a large quantity, they asked for more of one configuration than a single cart line can carry. Publishing warns about this with "With … a shopper can order at most … of this configuration on a single cart line". Keep the quantity a shopper can choose at or below that number, or charge more of the price through options or linked products.
If it only happens in one market, the cause is different: the configurator could not read Shopify's prices for that market on the shopper's page, or the prices there could not make up the configured amount, so the configuration was refused rather than charged at an amount that would not match what was shown. Publish the project again, then place a test order in that market - see Other currencies. If that market includes tax based on the shopper's country instead, only Product lines charging follows it - see Other currencies.
"Your cart already has N customized products"
What happened. There is a limit on how many configured products one cart can carry, and this cart has reached it. The message names the number: the lowest limit among this configurator and the configured items already in the cart. Publishing works out each project's limit, and it can be anywhere from one to four - see Managing complexity. Where the limit is one, the message reads "Your cart already has a customized product". Checkout can report the same limit in its own wording.
What to do. Ask the shopper to check out what is already in the cart and order this product separately, or to remove configured items until fewer than the number the message names remain.
"This cart has too many configured extras for us to check the prices"
What happened. With Product lines charging, a configured item can add many lines to the cart - one for each product or part it links, and for each priced option unless the options share one combined charge - and checkout can check only so many lines in one cart. Several large configurations together can pass that, even when each fits on its own.
What to do. Ask the shopper to remove an item, check out, then place a second order for the rest. If shoppers meet it often, combine the option lines into one charge - see Managing complexity.
"…could not be checked out together with everything else in your cart"
What happened. A configuration with parts picked from your variants checks out only when checkout joins it to its product, and this time it could not - usually because the cart holds too much for checkout to join every configuration in it.
What to do. Ask the shopper to remove some other items, or to remove the product and add it again. If it happens with a small cart, contact us.
"…can only be bought together with the customized product it belongs to"
What happened. The cart holds one of the helper products 3D Bits creates to carry part of a configured price, without the configured product it belongs to.
Usual causes, in order of likelihood:
- A shopper removed the configured product but kept a helper line, such as their uploaded file
- A product of your own that carries the tag 3d-bits-generated, or a copy of a helper product
What to do. Ask the shopper to remove the line and configure the product again on its page. If the product named is one of your own, remove the tag 3d-bits-generated from it in Shopify admin, and do not sell copies of helper products.
"This combination of options is not sold"
What happened. A part picks one of your variants, and the shopper's choices land on a combination with no variant in Shopify, or one you set to Not sold.
What to do. Nothing, if you do not sell it. To sell it, create the variant in Shopify, refresh the part in the Composer and publish. Ticking Disable options that cannot currently be sold (live catalog) crosses such combinations out before the shopper reaches Add to cart.
When a publish is refused
Publishing stops rather than going live with a setup that would charge incorrectly. The message names the cause.
Why Publishing Was Refused is the one list of refusals: each message, and what to change. Two of them need a word of their own.
A configuration cannot be charged, naming selections and a shortfall. The options or parts chosen there charge less than the products they add. Raise their prices by at least the amount the message names. Raising the base price does not help in Product lines, where it is your product's price.
A part picks a variant. Those refusals are further down this page.
"…3D Bits also could not put this configurator's helper products back the way your published version uses them, so publish again as soon as you can."
What happened. A publish can be refused after it has already updated the hidden helper products. 3D Bits then puts them back the way your live configurator uses them. This sentence, at the end of a refusal, means it could not, and the projects list marks the project Republish needed.
What to do. Fix what the rest of the message names and publish again as soon as you can. Until then, shoppers may be charged or refused differently from what the live configurator shows.
Parts picked from your variants
These messages come from a part that picks one of your variants. Each heading quotes the start of the message publishing shows.
"a part picks a product's variant, which only Product lines can charge"
Bundled parts cannot charge a part that picks one of your variants. Switch the project to Product lines charging, or link the part to one fixed product.
"… picks from this configurator's own product"
A part cannot pick from the product the configurator sits on. Pick it from another product, one without a configurator.
"… picks from "…", which is itself a configured product"
Another configurator is published to that product, and checkout would check its pricing again with every line of it. Pick the part from a product without a configurator, or unpublish the project that configures it.
"… picks from "…", which is …"
The product is a draft, archived, or not published to the Online Store sales channel. Set it to Active or Unlisted and publish it to the Online Store, or remove the part.
"… picks from a product that no longer exists, or the app can no longer see it"
The product was deleted, or is out of the app's reach. On the part in the Composer, choose Refresh from Shopify (the refresh icon): the part says the product is gone and offers Pick the replacement. Or choose Pick another product at once. Either way the choices keep their matches where the new product has values of the same names.
"the variants of the product "…" picks from could not be read from Shopify"
Shopify did not answer. Publish again.
"the product "…" picks from no longer has …"
An option of the product, or a value a choice picks, was removed in Shopify. The message names which. A rename is followed instead, unless the part was last read from Shopify before renames were followed. Refresh the part in the Composer, match its options or that value again, and publish.
"… can no longer tell which value of its product …"
Two values swapped names in Shopify, or one was renamed and a new value took its old name, or two of them now carry one name, and a choice picks one of them. The part matched the value by what it was, so a choice could now pick the wrong variant. Refresh the part in the Composer, check the matches it lists, and publish. Values no choice picks never stop publishing this way.
"… matches more than one of its options to the option …"
Two of the part's options now stand for one option of the product. Refresh the part and match its options again.
"the product "…" picks from has the option …, which the part does not match"
An option was added to the product in Shopify, so one choice could stand for more than one variant. Refresh the part and choose what picks the new option.
"a variant of the product "…" picks from changed in Shopify since the part was set up"
The message starts with the number of variants when there are several. A variant a choice picks now has other option values in Shopify, so the part no longer recognises it. Refresh the part in the Composer, match the values again and publish. A change to a variant no choice reaches does not stop publishing.
"none of the choices of "…" picks a value of …"
Every choice of the control that picks that option is set to Not sold, so the part could never be sold. Match a choice to a value in the Composer.
"… picks its "…" by a control the configurator no longer has"
The control the part picks an option by was deleted. If it was changed to a kind that cannot pick a variant, the message reads "… by a control the configurator cannot match it by (only a dropdown or radio can)" instead. The same refusal starts "… matches "…" of "…", which that control no longer offers" when a matched choice was removed from its control; the part shows it as a row ending no longer offered by the control. Match the part's options to your controls again in the Composer, or remove the stale row.
"a part picks a variant this configurator also charges another way"
An option or another part links the same variant, so every cart carrying both would be refused. Pick the variant for one of them only, or link another product.
"checkout cannot read the record 3D Bits keeps of …"
Nothing you set up causes this. Contact us with the message.
"the choices your parts pick variants by, beside the products this configurator charges, take more room than checkout reads for one product"
Match fewer choices to variants, or charge fewer products through this configurator.
More than 2,000 units on one cart line
A configuration with a part picked from your variants checks out only as one line joined to its product, and Shopify joins a line of at most 2,000 units. Three messages say so:
- "… puts more than 2000 units on one cart line for a single configuration" - a part's own quantity is that large. Lower the quantity, or sell the part in packs.
- "with … one line of the group carries … units, more than the 2000 Shopify joins to its product" - the configuration the message names reaches it. Lower that quantity, or sell the part in packs.
- "with … the part of the price collected through the price-unit line needs … units on one cart line" - the 3D Bits - Configured price helper product carries too much of the price. Charge more of it through options or linked products.
Parts picked from your variants and the cart limit
A part picked from your variants takes a little more room in a cart than other lines, so many of them lower how many configured items one cart holds - see How many configured items fit in one cart.
- A warning that starts "Shoppers can add … configured items of this product to one cart" and goes on to count the lines each configuration adds names the cart limit. Fewer parts per configuration raises it; charging the options through one combined line also helps.
- "even a single configured item cannot be verified at checkout: one configuration adds up to … cart lines" stops the publish. Pick fewer parts from your variants in one configuration - a part that stays the same whatever the shopper chooses can link one fixed product instead. Where the message names options on lines of their own, charging them through one combined line also frees lines.
- A cart-limit warning that goes on "At checkout each configuration's parts chosen from your variants are merged under it" means a whole cart's joined configurations must fit what checkout can write. Fewer parts per configuration, fewer choices, or fewer products linked to it raise the limit.
- "even a single configured item cannot be verified at checkout: at checkout … are joined to the configured product with everything the shopper chose and typed" stops the publish for the same reason, at one configuration. Pick fewer parts from your variants, or offer fewer choices and text fields.
"Long product names take room too"
A cart-limit warning, or a message that stops the publish, can end with "Long product names take room too". A name longer than about 200 characters, or fewer when it has accented letters or characters of other scripts, takes room from the other lines. Shorten the names the message lists, your product's own name or the name of a linked product or part, and publish again.
"3D Bits could not finish setting up checkout for the parts chosen from your variants"
Nothing is wrong with your setup. Publish again in a moment, and if it keeps happening, contact us.
"Shopify did not save what checkout needs to know about the variants your parts pick from"
Shopify did not take what 3D Bits records about your variants. Publish again in a moment. If the message says "Shopify no longer has a variant a part picks from" instead, refresh the part in the Composer and publish.
"the Cart Transform could not be activated, so the parts chosen from your variants could not be joined to their product"
The checkout mechanism that joins these parts to their product is not available on your store right now. Open the app from your Shopify admin, accept any permission prompt, and publish again.
Warnings after a publish
"A price formula reads "…", which has no minimum value"
What happened. A number control that a price depends on has no minimum value.
What to do. Set a minimum on that control in Composer, usually 0, and publish again. If a logic rule or a script changes the control's range, give that range a minimum too.
"A price formula names an input it reads with an expression rather than in quotes"
What happened. A price formula works out the name of an input it reads instead of naming it - input("size_" + n), for example, or selectedCount("ext" + "ras").
What to do. Name each input the formula reads, either plainly, such as width, or in quotes, such as input("extra-panels") for a key a plain name cannot spell. Then publish again. A formula that picks between several inputs can name each one.
"A linked product costs something different in Shopify now"
What happened. With Product lines charging, a product the configurator links has a new price in Shopify. Shoppers already pay Shopify's current price for it, and the configurator shows it.
What to do. Sync prices and publish saves the new price in the configurator. Nothing is mis-charged in the meantime.
"In Product lines a shopper who picks a variant of the product pays that variant's price as the base"
What happened. Some variants of the product the configurator sits on cost more or less than the base price. The message names each one and what a shopper choosing it pays.
What to do. Nothing, if that is what you intend. If every shopper should pay the same, give every variant the base price in Shopify.
"3D Bits could not finish setting up checkout for this configurator"
What happened. The configurator was published, but until 3D Bits finishes setting up checkout, checkout holds it to the prices it was published with. A price you change in Shopify for this product, or for a product it links to, can then stop shoppers checking out.
What to do. Publish again to finish the setup. If the warning keeps coming back, contact us.
"Shopify renamed …"
What happened. An option or a value the part picks was renamed in Shopify. Publishing used the new name, and shoppers see it.
What to do. Refresh the part in the Composer to see the new name there too.
"Shopify has a variant of the product "…" picks from that the part was not set up with"
What happened. A variant was added in Shopify after the part was set up, or a variant the part was set up with now has values the choices reach, so the configurator does not sell it yet. The message starts with the number of variants when there are several.
What to do. Refresh the part in the Composer and publish to sell it.
"With "…", a combination the choices can reach has no variant in Shopify, so shoppers see it crossed out"
What happened. Some combinations of the choices a part picks variants by have no variant in your product.
What to do. Create the variant in Shopify and refresh the part, or leave the combination unsold.
"a variant "…" was set up with no longer exists in Shopify"
What happened. A variant the part picks was deleted in Shopify, so shoppers see that choice crossed out. The message starts with the number of variants when there are several.
What to do. Refresh the part in the Composer and publish.
Nothing is wrong, but nothing appears
No price shows on the product page. Check the project is published, that pricing is switched on, and that the product is linked to the project.
The configurator is replaced by a short message. The project is paused - see Linked products. Press Resume selling on the project page.
Prices look right in Composer but not on the storefront. Most often you have unpublished changes: publish. With Product lines charging, the storefront also shows Shopify's current price for a linked product, and the price of the variant the shopper picked as the base, where Composer shows the prices you saved. A shopper paying in another currency, or in a market that includes tax based on the shopper's country, sees the amounts for their market - see Other currencies.
No discounts on the Price element. They appear only when Shopify gives this configuration a discount and prices it at exactly the total shown. Check that the discount is active and covers this product, that the code is on the shopper's cart (or the discount is automatic), and that the shopper pays in your store currency - in a converted currency the rows are usually hidden. Discounts that need other items in the cart, and customer-only discounts, show at checkout instead. Pricing test mode shows no rows, and a subscription price usually hides them. The Price element's Show the store's discounts must be ticked.
The promo code chip never states a saving. The code does not lower this configuration's price - it may be misspelled, expired, limited to other products, or waiting for a minimum spend. Other reasons the saving is not stated: the shopper pays in another currency, the store is in Pricing test mode, or the code is the third or later different code across your Price elements (only the first two are checked). A code limited to logged-in customers or B2B buyers never states a saving on the product page, because the page asks Shopify without knowing who the shopper is; after Apply the chip says the code is on the cart and any saving applies at checkout, and checkout gives the saving to a shopper who qualifies. For any other code, press Apply on the product page and, if no saving appears, check the discount's conditions in your Shopify admin.
Still stuck?
Tell us the store, the product, and what the shopper saw - see Please reach out. Knowing your product pages helps us help you.
Verified against the product in November 2026