Set up Gelato in 5 minutes

1. Go to the Gelato dashboard → Developer → API keys.
2. Add an API key, give it a name (e.g. OneClickRemix key), save, then copy the key to your clipboard.
3. Go to My account → Print on demand supplier, paste the key, and click Connect Gelato.

After connecting, add every Gelato shop you sell on in My account (Store library). You can add as many stores as you need.

1. Go to the Gelato dashboard → Stores, open a shop.
2. Copy the UUID from the URL:
   …/stores/6ada0d2f-73f4-41f4-af92-91911c22171d/products
3. Paste the UUID into Store library and click Add. Optionally add a shop name to push products to the right store more easily.

After a remix is done, you will be able to choose which Gelato store you want to push your new product to.

A template is your reusable product setup (variants, print area, description, pricing…). Once your remix is generated, you will be able to select one of your templates. OneClickRemix will fill in the design, title, and tags of your template and add a new product draft to your Gelato account, ready to publish in one click.

Quick path

1. Gelato dashboard → Templates → Create a template.
2. Pick any mug, apparel, or poster from the catalog.
3. Select the sizes / colors / formats you want to sell by default (you can edit them separately for each product before publishing).
4. In the editor: upload a placeholder design (see below) and adjust the placement. The OneClickRemix design will replace this image when creating a new product.
5. Click + Save design.
6. Click Continue to Mockups. Set the default mockups for your listing.
7. Click Continue to Details. Set a default description with generic store and product info (materials, care instructions, shipping times, your brand story…). This description is kept on every product. OneClickRemix will add a SEO copy optimized for the audience of your product above the description of your template.
8. Click Continue to Pricing. Set default pricing.
9. Click Continue to Review, then Save template. Give your template a clear name so you can find it easily in OneClickRemix.

Placeholder designs

Below, you can find placeholder designs to add to your templates. OneClickRemix will automatically replace these placeholder designs with the Remixed designs when creating new product drafts.

If you have multiple placeholder designs on your template, they will all be replaced by the Remixed visuals (ex: recto and verso of a mug).

You can add other designs (ex: your brand logo), they will stay untouched.

Format	Aspect ratio	Download
Square	1:1Best for mugs	PNG
Portrait	3:4Best for t-shirts & for posters.	PNG
Portrait	2:3	PNG
Landscape	3:2	PNG
Landscape	4:3	PNG

Download all formats (ZIP)

Which format to choose for posters?

Format 3:4 (recommended)

• Perfect fit (native ratio): 30×40 cm (12×16"), 45×60 cm (18×24").
• Works with minimal crop: 13×18 cm (5×7"), 50×70 cm (20×28").
• Acceptable for A4, A3, A2: requires top/bottom cropping (or side margins).

Format 2:3

• Perfect fit (native ratio): 20×30 cm (8×12"), 30×45 cm (12×18"), 40×60 cm (16×24").
• Acceptable for A4, A3, A2, 50×70 cm (20×28"): requires side cropping (or top/bottom margins).

Gelato FAQ on how to create templates

Creating products via API from template →

In Gelato, go to your saved templates.

You have two options to find your Template ID:

Option 1 — Copy from your library of templates

1. Hover a template with your mouse.
2. Click the three dots ⋯ → Copy template ID.

Option 2 — From the template URL

1. Open your product template.
2. The URL will briefly look like this:
   https://dashboard.gelato.com/e-commerce-product-wizard/edit-product-template/7c5e1a9d-3f8b-4e6d-a2b1-91f74d3c8e5a/2b8d6f43-c1a7-4d92-8f3e-5a9c17e4b6d2
3. Copy the last UUID from the URL (bold segment above — there are two IDs in the path).

My account → Template library → paste → Add.

1. Run a Remix by opening the Remix studio, either by clicking on the extension icon to open the side panel or at oneclickremix.com/remix-studio.
2. When the remix is done, you will be able to select a template from your library.
3. You can publish your product draft from Gelato to Etsy in one click.

What you see	How to fix it
“Sign in at oneclickremix.com”Extension popup or panel	Sign in at oneclickremix.com. Open My account and connect / pair the extension. Retry from the extension popup or My account.
Invalid API key or Store IDWhen connecting or adding a store	Create a new API key in Gelato → Developer → API keys. Copy the full key — no spaces before or after. When adding a store: paste only the UUID from your store URL (…/stores/uuid/products).
Template IDs are account-specificWhen adding a Template ID	You cannot reuse another seller’s ID. Always copy the ID from your own Gelato dashboard.
Template not foundWhen adding a Template ID	The template must belong to the same Gelato account as your API key. Open your templates and copy the ID from there.
No template in the panel“Push to Gelato” has no dropdown	My account → Template library → paste → Add. If your template has several designs and none are named oneclickremix…, choose which design(s) to replace in the dropdown, then click Add. Repeat for each template you want (e.g. white mug + color mug, or t-shirt + hoodie).
Text or design clipped on mockupPreview looks cut off	OneClickRemix uses the placement you set in Gelato. Open the template in Gelato, reposition or enlarge the print area, save the template, then run a new remix. Make sure the format of the design you are generating matches the format of the design on your template. For example, pushing a 3x4 portrait design on a square design will cause issues (cropping, ratio…).