This guide translates the error messages you might see in Composerie into plain language, and tells you what to do about each one. It is for store owners who hit a message on the storefront, in the customizer, or in the dashboard and want to know whether it is a quick fix or a reason to contact support.
How to read this page
Start by copying the exact words of the error. The wording is what matches each entry below, so read it carefully before you act.
Some messages come from Composerie, and some come from Shopify. The wording tells you which. Composerie messages use the labels you see in this guide, like “Store not found” or “Mapping API timed out”. Shopify messages often follow a Composerie message and describe a store rule, like “sold out”.
For most errors, the fastest path is the dedicated article linked from the entry. That article walks through the full fix. Use this page to identify the message, then follow the link.
Storefront and customizer messages
These are the messages you or a shopper can see when the customizer tries to load a product or add a personalized design to the cart. Find the one that matches your text.
Store not found
Composerie cannot match your shop domain to a connected store. The store is either not connected yet, or the connection was removed. Reinstall or reconnect the Shopify app, then reload the product page. See the customizer not appearing article for the full reconnect steps.
No designs linked to this product
The product loads, but no design is attached to it. Open the product in your dashboard, link a design, and republish the product. After it republishes, reload the storefront product page and the customizer will appear.
Cart add failed
The personalized design could not be added to the cart. Read the Shopify text that follows this message. It is usually the real reason, such as a sold-out variant or a selling rule. Fix that condition in Shopify, then try again. The product will not add to cart article covers the common causes.
Mapping API timed out after 5s
The customizer asked Composerie for the product setup and did not get an answer within five seconds. This is almost always a slow or interrupted network. Reload the page to retry. If it keeps happening, confirm the storefront can reach the Composerie app and is not blocked by a firewall or ad blocker.
Failed to load mapping
The customizer reached Composerie but got an error response instead of the product setup. A status code follows the message. Reload to retry. If the same code keeps coming back, copy the full message and contact support.
The “Store not found” message appears when the connection between your shop and Composerie is missing. The screenshot below shows where it surfaces.
For the connection-level fix, see customizer not appearing. For add-to-cart problems, see product will not add to cart.
Dashboard and AI messages
These messages show up inside the dashboard, often while you are working with AI features. They tell you whether to retry or to reach out for help.
Style definition unavailable
The AI style you picked could not be found, so the request stopped before generating anything. Choose a different style and try again. If your usual style is missing for everyone, copy the message and contact support.
Internal server error
Something failed on the Composerie side, not in your setup. This is usually temporary. Wait a moment and retry the same action. If it keeps failing on the same step, contact support and include what you were doing.
A good rule of thumb: a message that names a specific input you chose, like a style, means try a different choice and retry. A generic message like “Internal server error” means retry once, and if it persists, the problem is on our side and worth reporting.
When a message persists after a retry, reach out through contact support with the full text.
Next
If your message is about orders rather than the storefront, see orders not reaching provider.