Assets & tasks / MERCHANT WORKFLOW
Why Does Your Gelato Etsy Listing Show Mockups for Only One Product Color?
Gelato documents that its Etsy integration generates listing mockups only for the main garment or frame color selected during product creation. Additional colors do not automatically receive their own published mockups. To show those colors, prepare suitable additional images and upload them directly through Etsy, then verify the relevant variation-image links and listing policy.
Separate purchasable variants from published mockups
A Gelato product can contain multiple color variants while the generated Etsy listing media shows only the selected main color. This is a documented publishing behavior, not proof that the other variants were omitted from the product configuration.
Gelato's Etsy mockup instructions say merchants choose mockup scenes and a primary image during product creation. When several garment or frame colors are offered, the automatically generated mockups represent the selected main color.
The help also documents Etsy's ten-image limit and explains that Etsy links variation images by one variation option, such as Color or Size. Merchants must inspect the actual listing's variation structure rather than assuming every color-and-size combination can have an independent image association.
Keep the production variant, the image depicting that variant, and the selected Etsy image association as three separate records. A photographed Blue shirt does not become linked to Blue simply because its filename includes the word.
Prepare additional color views through the correct owner
In Gelato, confirm the connected Etsy product, its available variants, and the selected main mockup color. Record which additional colors need representation.
Obtain suitable approved mockups or real photographs for the missing colors. Gelato documents downloadable high-resolution mockups, subject to the applicable access and workflow restrictions. Review the actual garment model, print artwork, color, and visible construction before using an image.
Upload the supplemental files directly in Etsy's listing editor. For a new listing, Gelato's instructions point to Variations and Manage Variations when configuring the relevant option. For an existing listing, they identify Variations and Link Images.
Use the actual Etsy image rules for the product's production model. The Etsy product-photo guide distinguishes real-photo requirements and specific production-partner exceptions. Gelato's technical ability to create a mockup does not itself establish Etsy policy eligibility.
Do not replace the entire image set merely to add one missing color. Review the available gallery slots and preserve any important real-product evidence already present.
Hypothetical three-color T-shirt
Hypothetical exercise. No Gelato or Etsy product was created or inspected. A fictional seller offers product GEL-TEE-730 with variants TEE-BLK-M, TEE-SAND-M, and TEE-SAGE-M.
All three use approved print artwork north-arc-v2.png. Black is the proposed main mockup color. The merchant prepares three color-specific image candidates: tee-black-front-v2.jpg, tee-sand-front-v2.jpg, and tee-sage-front-v2.jpg.
The expected listing contains an accurate Black main image and additional Sand and Sage images. Whether Etsy allows those images for this specific item must be checked against its current listing-image requirements.
| Variant | Image role | Proposed publication | Actual state |
|---|---|---|---|
| TEE-BLK-M | Main color | Gelato-selected mockup | Not published |
| TEE-SAND-M | Supplemental color | Manual Etsy upload | Not uploaded |
| TEE-SAGE-M | Supplemental color | Manual Etsy upload | Not uploaded |
Diagnose missing color evidence and incorrect links
If the Sand and Sage variants exist but their photographs are absent, first inspect the selected main mockup color. The documented Gelato behavior explains why additional colors may require a manual Etsy media update.
If the photographs are present but choosing Sage displays Sand, inspect Etsy's Link Images configuration and the actual variation option used for image association. Do not alter Gelato's print design to repair a storefront image link.
If the seller has reached Etsy's image limit, prioritize images that identify the product and explain real differences. Remove redundant scenes only after considering the applicable authenticity and item-type rules.
If an uploaded image depicts the wrong garment or artwork, reject that file and obtain an accurate source. A successful Etsy upload does not establish correct merchandise representation.
For general grouped-gallery behavior, see the Shopify variant-gallery guide, but do not transfer Shopify's media controls to Etsy.
CartVisual does not configure Gelato variants, upload Etsy media, or guarantee marketplace acceptance.
Use the example with your own product records
The filled records are hypothetical editorial examples. The entry-template row is for your own files, settings and observations; it does not connect to another application.
| Fictional SKU | Color | Print artwork | Image file | Publishing route | Actual Etsy image | Actual variation link | Next action |
|---|---|---|---|---|---|---|---|
| TEE-BLK-M | Black | north-arc-v2.png | tee-black-front-v2.jpg | Gelato main-color mockup | Not inspected | Not checked | Verify primary image |
| TEE-SAND-M | Sand | north-arc-v2.png | tee-sand-front-v2.jpg | Manual Etsy upload | Not uploaded | Not configured | Review eligibility and link |
| TEE-SAGE-M | Sage | north-arc-v2.png | tee-sage-front-v2.jpg | Manual Etsy upload | Not uploaded | Not configured | Review eligibility and link |
What the sources establish
- Gelato — How can I add mockups to my products on Etsy?: Verified main-color-only automatic mockup generation, manual upload of additional colors, ten-image limit, and Etsy variation-image linking instructions.
- Gelato — Can I download mockups?: Verified downloadable mockup formats, Gelato+ access requirements, and workflow-dependent download availability.
Sources and further reading
Recorded source-review dates are listed individually below. An undated source does not inherit the article’s publication date. Software and platform rules can change; check the current original before acting.
- Gelato — How can I add mockups to my products on Etsy? · Review date not separately recorded
- Gelato — Can I download mockups? · Review date not separately recorded
Frequently asked questions
Does one Gelato mockup color mean only one garment color is available?
No. The mockup color selected for automatic Etsy publication and the product's configured purchasable variants are separate records.
Can Etsy link images to every color-and-size combination independently?
Gelato's current instructions describe linking images through one variation option. Inspect the actual Etsy listing configuration before assuming combination-specific image behavior.
YOUR NEXT CAMPAIGN
Create assets from a clear source
Bring your reviewed source photo or brand brief to CartVisual. Check the current tools, account access and credits before generating, then compare every result with your source.
Create a CartVisual account Open the workspace Check access and credits