A shopper personalized a product but it will not add to the cart. This guide walks you through the usual causes, in the order worth checking, so you can find the one that applies to your product. It is written for merchants troubleshooting their own store.
Most of the time the cause is one of three things: a required field left empty, a sold-out variant, or a theme that interferes with the add request. Work through them in that order.
Check the obvious causes first
Start with the things you can confirm in a few seconds on the product itself. Open the product the same way a shopper would and try to add it. The message you see usually points straight at the cause.
Fill in every required field
If a personalization field is required and the shopper leaves it empty, the customizer will not let them continue. It shows the message “Please fill in this field” with the name of the field, so you know exactly which one is missing. Fill that field in, then continue.
To control which fields are required, see make fields customer-editable.
Check the variant is in stock
If a variant is sold out, the customizer marks that option as “Out of Stock” and disables it. A disabled option cannot be selected, so the add will not go through for that combination. Pick an available option, or restock the variant in Shopify.
Composerie reads stock straight from Shopify, so it only marks an option as out of stock when every variant with that value is unavailable. For how variants flow through to checkout, see variants, options, and add-ons.
Look for a Customize button instead of Add to cart
On full-page products there is no Add-to-cart button on the product page by design. Composerie hides the native Add-to-cart and the dynamic checkout buttons and shows a Customize button in their place. The shopper clicks Customize, personalizes the product, and adds it from the customizer. If a shopper says the Add to cart button is gone, this is expected behavior, not a bug. See storefront modes explained.
Reproduce it yourself
Open the exact product that is failing and run through it as a shopper would. Seeing the real message in context tells you which of the causes above applies. Note the wording, because the next section uses it.
Read the message Shopify returns
When the add request reaches Shopify and Shopify rejects it, the customizer does not fail silently. It shows the error text that Shopify itself returns, so the shopper (and you) can see what went wrong. The button switches to a “Couldn’t add, try again” state, and the underlying message describes the reason.
This text comes from Shopify’s own checkout rules. Common reasons include a variant that is unavailable, a quantity gate (a minimum or maximum per order), or a sold-out variant with a deny policy. Because the rule lives in Shopify, the fix is usually in the product’s inventory or selling settings, not in Composerie.
Copy the exact text you see and match it against error messages explained. That article maps the common messages to their cause and fix.
Rule out a theme that blocks the add
Composerie does not run its own cart endpoint. Instead, it adds the personalization details onto the theme’s normal Add-to-cart request as line item properties. It does this by hooking into the request the theme already sends, whether the theme uses a fetch call, an XMLHttpRequest, or a plain form submit.
This works with almost every theme. But if a heavily customized theme or another app fully replaces the add flow with its own, Composerie may not be able to attach the personalization properties. In that case the product can still add to the cart, but the personalization details are dropped from the line.
To check whether the theme is the cause, test the same product on a clean default Shopify theme (for example Dawn). If the personalization comes through on the default theme but not on yours, the conflict is in your theme or another installed app.
For the technical detail of how this attachment works, see how the cart interceptor works. To confirm variants line up with Shopify at checkout, see variant sync and checkout.
Frequently asked questions
The Add to cart button does nothing. What is wrong?
Usually a required field is empty or the selected variant is sold out. Check both first. If there is no Add to cart button at all, the product is in full-page mode and you customize it before adding.
There is no Add to cart button at all on this product.
That product is in full-page mode. Composerie replaces the native Add to cart with a Customize button. Click Customize, personalize the product, then add it from the customizer.
The product adds but the personalization is missing in the order.
Another app or a customized theme may be replacing the add request, which drops the personalization properties. Test the same product on a default theme to confirm.
If you have worked through all three causes and the product still will not add, contact support with the product link and the exact message you see.
Next
Keep error messages explained handy to translate any Shopify message into its fix.