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.
Two places have enough messages to deserve their own page: Design Studio messages and what stops publishing.
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. Check the exact shop domain and its existing connection in Integrations. Use reconnect if the connection requires it, 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. Check the publication result for the intended store, then reload the storefront product page. If it is still missing, also check the display mode and theme placement.
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. The message alone does not identify whether the delay is in the network or service. 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.
A third message on that same screen is about time rather than configuration. “This preview or access link has expired. Please reload the page or reopen the customizer.” means the link you followed was signed for a shorter life than the tab has been open. Reloading mints a new one; there is nothing to repair.
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
The request failed on the server, but the message alone does not identify the cause or whether an earlier step completed. Check the result before repeating an action that creates an order or payment. For a failed load, retry once; if it persists, contact support with the action and error.
A good rule of thumb: a message that names a specific input you chose, like a style, means try a different choice and retry. For a generic message like “Internal server error”, check the action’s result before retrying a mutation. A failed page load can be retried; order recovery should follow the order-specific guide.
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.