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.
Start with required fields and choices, variant availability, and the exact error shown. Composerie can also block the handoff before Shopify receives a cart request, for example when personalization or a processed image has not been accepted.
If what is missing is the theme’s own Add to cart or Buy it now button rather than the customizer, that is deliberate. See why Buy it now disappears.
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 names the field, in red, above the field itself: “Please fill in: Headline”. Fill that field in, then continue.
On a step-by-step customizer the refusal comes early, at the step boundary, before anything is sent anywhere. On a single-page one it comes at add to cart instead, worded as “Please complete” and the field’s name.
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.
Check the variant in both the Composerie publication and Shopify. A selectable option alone is not proof that Shopify will accept it at checkout. For how variants flow through to checkout, see variants, options, and add-ons.
Look for a Customize button instead of Add to cart
For Full page, check that a working Customize entry opens the intended customizer and that its cart handoff works. A missing Add to cart button by itself does not establish that the product is correctly configured. 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
The cart path depends on the storefront mode and controls in use. The customer customizer saves and validates personalization before its Shopify cart handoff. Theme integration must also preserve the required line-item properties; checking only the theme’s native button is not a complete test.
If a customized theme or another app replaces the add flow, check whether the personalization properties survive. 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?
Check required fields and choices, image-processing status, the selected variant, and the error message. If the button is absent, check the display mode and whether a working Customize entry is present.
There is no Add to cart button at all on this product.
Check the publication mode. For Full page, a working Customize entry should lead to personalization and the cart handoff. If that entry is also missing or broken, follow the theme-placement checklist.
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.