> ## Documentation Index
> Fetch the complete documentation index at: https://help.mockspark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Publish a Product to Etsy

> Add a production partner, fill in the Etsy settings, and push your product live as a real listing

Publishing is the last step of building a product. If you have not built one yet, start with [Products](/docs/products/products) and [Personalizer](/docs/products/personalizer), then come back here.

## First, Add a Production Partner

Etsy requires every print-on-demand seller to declare who physically makes their items. Without one, Etsy refuses to create the listing, and the error it returns is `Oh dear, you cannot sell this item on Etsy`, which sounds like your shop is banned. It is not. It only means the production partner is missing.

Etsy's API has no way to add a production partner, so this is something you do once, by hand, in your Etsy account.

<Steps>
  <Step title="Open the production partner settings">
    In Etsy Shop Manager, go to **Settings** then **Partners you work with**, and click to add a partner.

    <Frame>
      <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/pp-settings-nav.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=76f6a4ed0800069f6274e71da28bf33c" alt="Etsy Shop Manager with Settings expanded, Partners you work with selected, and the Add production partner button" width="1184" height="838" data-path="images/connections/etsy/pp-settings-nav.png" />
    </Frame>
  </Step>

  <Step title="Name the company that prints your items">
    Enter the company that actually prints and ships your products. If you fulfill through Printful, that is Printful. If you fulfill through Printify, that is Printify. Set **Location** to where that company produces your items.

    <Warning>
      Name the printer, not your design software. Etsy defines a production partner as the outside company that physically makes the item. Naming a tool instead of the printer counts as an inaccurate disclosure, and the risk falls on your shop.
    </Warning>

    <Frame>
      <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/pp-add-form-top.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=26d76df2e1f548126e7fd9559ffae8f5" alt="The Add a production partner dialog on Etsy with the partner name, Show this to buyers toggle, and Location filled in" width="1181" height="435" data-path="images/connections/etsy/pp-add-form-top.png" />
    </Frame>
  </Step>

  <Step title="Describe what they do for you">
    This description is shown to buyers, so keep it clear and honest. Say that they print your designs and ship the orders. Something like:

    > I create all the designs myself. This partner prints them onto the finished products, packs and ships each order directly to my customers.

    Avoid vague lines like "they help with my shop". Etsy wants buyers to understand the arrangement.

    <Frame>
      <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/pp-what-they-do.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=1b35e8de595a33213caa0a6185e2dd4b" alt="The What they do for you field on Etsy filled in with a description of the printing arrangement" width="1181" height="550" data-path="images/connections/etsy/pp-what-they-do.png" />
    </Frame>
  </Step>

  <Step title="Answer the three questions about the partnership">
    **More about your partner** has three dropdowns. Etsy keeps these answers internal, so buyers never see them.

    **Why do you work with this partner?** Most print-on-demand sellers pick *I don't have the technical ability or equipment to make it entirely by myself*, which is the honest answer if you do not own a printer.

    **What is your role in the design process?** Pick *I design everything myself* if the artwork is yours.

    **What is your partner's role in the production process?** Pick *They do everything for me*. Printful and Printify print your design, pack the order, and ship it straight to your buyer. The item never passes through your hands, so the other options do not apply: you are not assembling components, altering a finished product, or adding your own packaging.

    That answer does not take credit away from you. The design question above already records that the artwork is yours. Together the two answers say what is actually true, which is that you design everything and your partner produces everything.

    Save when you are done.

    <Frame>
      <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/pp-more-about.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=a84d9281a1fb8b96aa907e46678e698e" alt="The three More about your partner dropdowns on Etsy, filled in, with the Save partner button below" width="1183" height="645" data-path="images/connections/etsy/pp-more-about.png" />
    </Frame>
  </Step>
</Steps>

<Tip>You only do this once per shop. After it is saved, it appears in Mockspark's publish form for every product.</Tip>

## Fill In the Etsy Settings

Back in Mockspark, open your product. Building a product runs in three steps, shown along the bottom of the page.

<Frame>
  <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/product-builder-steps.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=bb500a7df7ac4450b09c3f8e1ad82ddd" alt="The product builder with its three step progress bar along the bottom of the page" width="1185" height="945" data-path="images/connections/etsy/product-builder-steps.png" />
</Frame>

Steps 1 and 2, the product details and the mockups, work the same whichever platform you sell on. [Products](/docs/products/products) walks through both.

Everything below is **Step 3, Publish to store**, which is where the Etsy settings live.

### Shop and Platforms

**Store** is the Etsy shop this product will be published to. You can switch shops while the product is still a draft. Once it has been published, the shop is locked.

**Sales platform** and **Fulfillment platform** are shown for reference. They come from how the product was created.

### Production Partner

Pick the partner you added earlier. This field is required, because Etsy rejects the listing without it.

If the dropdown is empty, the partner has not saved on Etsy's side yet. Add it, then reload this page.

### Store Currency and Weight Unit

**Store currency** should match the currency your Etsy shop sells in. Prices you set on the variants are read in this currency, so getting it wrong produces prices that are off by a lot.

**Weight unit** only matters if your print provider needs shipping weights. Leave it as **No weight** if you are not sure.

### Etsy Category

Mockspark preselects a category based on the product type, so most of the time you can leave it alone. Change it if the guess is off, since the category affects where buyers find your listing on Etsy.

### Etsy Shipping Profile

Etsy handles shipping costs through shipping profiles that live in your shop.

If you already have profiles, the dropdown lists them. Pick the one you want and Mockspark attaches it to the listing.

If your shop has none yet, the dropdown holds a single extra option instead: **Mockspark Shipping (free shipping)**. Choosing it tells Mockspark to create that profile in your Etsy shop as part of publishing. It is a real profile, so it shows up in your Etsy shipping settings afterwards and you can edit it there like any other.

<Warning>
  Free shipping means the buyer pays nothing for delivery. It does not mean delivery is free. Your print provider still charges you for shipping, and that cost comes out of your margin. Price your items with that in mind, or set up your own shipping profile in Etsy instead.
</Warning>

The profile is created with your shop's own ship-from country, taken from your Etsy settings. If that country uses postal codes, Etsy requires one and does not share it through the API, so a postal code box appears under the dropdown and Mockspark asks you to fill it in once.

### Etsy Return Policy

Optional. Pick one of your shop's return policies if you have them.

Mockspark does not create return policies for you, because a return policy is a promise you make to buyers and that should be your wording, not ours. You can add one in your [Etsy shop policy settings](https://www.etsy.com/your/shops/me/policy-settings) and reload the page.

### Processing Time

You will notice there is no field for this. Mockspark sets processing time to **2 to 5 days** on every listing it publishes, which reflects how long print-on-demand production actually takes. If your shop already has a matching profile, Mockspark reuses it rather than creating another one.

### Buyer Personalization

Leave this off to sell a fixed design. Turn it on to let buyers make their own version before they buy. [Let Buyers Personalize Your Listings](/docs/connections/etsy/personalization) covers how that works from both sides.

### Variants

Set the price and availability for each variant. Prices are in the store currency you chose above.

## Publish

Click **Done & Publish**. Mockspark creates the listing on Etsy, uploads your photos, sets up the variants, and activates it.

When it finishes you get the listing URL and a **Check on Etsy** link that opens the live listing, so you can see what buyers see.

<Frame>
  <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/publish-success.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=d494b81db1ead56290fe43072775c8c2" alt="The publish confirmation showing the shop name, product title, listing URL, and a Check on Etsy link" width="1183" height="765" data-path="images/connections/etsy/publish-success.png" />
</Frame>

If something fails partway through, Mockspark removes the half-built draft it created so you do not end up with orphaned listings cluttering your shop. Fix what the error points at and publish again.

## Updating a Published Product

Change the design, prices, or photos in Mockspark and publish again. Mockspark updates the existing listing instead of creating a second one.

If you deleted the listing on Etsy in the meantime, Mockspark notices and creates a fresh one.

## When Publishing Fails

<AccordionGroup>
  <Accordion title="Oh dear, you cannot sell this item on Etsy" icon="circle-alert">
    This is Etsy's message for a missing production partner. It is not about your shop's selling privileges. Add a production partner as described at the top of this page.
  </Accordion>

  <Accordion title="Production partner is required" icon="circle-alert">
    Mockspark caught the same problem before sending it to Etsy. Same fix.
  </Accordion>

  <Accordion title="Shipping profile is required" icon="circle-alert">
    Pick a profile, or choose **Mockspark Shipping (free shipping)** to have one created.
  </Accordion>

  <Accordion title="The category dropdown is empty" icon="circle-alert">
    Etsy's category list failed to load. Reload the page. If it keeps happening, your shop connection may need reauthorizing. Check the [connections page](/docs/connections/etsy/connect) for a **Reconnect required** tag.
  </Accordion>
</AccordionGroup>

## Next

<Card title="Etsy Orders and Fulfillment" icon="package" href="/docs/connections/etsy/orders">
  What happens after a buyer places an order.
</Card>

***

The term 'Etsy' is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.
