> ## 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.

# Let Buyers Personalize Your Listings

> Give Etsy buyers their own designer, and produce exactly what they made

Personalization lets a buyer design their own version of your product before they buy it. They open a designer, place their text or image, submit it, and you produce that exact design.

## Why It Works This Way

Etsy does not let apps put a custom designer inside a listing page. The only field Etsy gives you for buyer input is **Personalization**, and it accepts plain text.

So Mockspark works with what Etsy allows. The Personalization field carries a link to the designer and collects a short ID that points back to the design the buyer made. It takes the buyer one extra copy and paste, and everything else is automatic.

## Turning It On

On the publish form, switch on **Let buyers customize this design**, then publish.

<Frame>
  <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/personalization-toggle.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=1233f6f8e2feaa576040601b63f1accc" alt="Step 3 of the product builder with the Let buyers customize this design switch turned on" width="1185" height="944" data-path="images/connections/etsy/personalization-toggle.png" />
</Frame>

Mockspark adds a required personalization question to your Etsy listing:

* The question is labelled **Customization ID**
* The instructions read `Open https://app.mockspark.com/guest/customize?p=etsy&ref=<your listing id> to design, then paste your ID here`
* The field accepts up to 36 characters, which is exactly the length of one ID

The link is unique to that listing, so the designer always opens the right product.

<Frame>
  <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/etsy-listing-personalization-field.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=23e98fcdc210bc790cdb5faa342d3df9" alt="An Etsy listing showing the Customization ID field, its instructions, and the 36 character limit" width="1183" height="785" data-path="images/connections/etsy/etsy-listing-personalization-field.png" />
</Frame>

<Tip>Turning the switch off and republishing removes the personalization question from the listing.</Tip>

## What the Buyer Does

<Steps>
  <Step title="Opens the link">
    The buyer copies the address from the personalization instructions and opens it. No account and no login.

    <Frame>
      <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/guest-designer.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=93dcabe7b74fcc1e7f0041f815171cd2" alt="The buyer designer opened from a listing link, with the variant selector and Submit customization button" width="1200" height="991" data-path="images/connections/etsy/guest-designer.png" />
    </Frame>
  </Step>

  <Step title="Designs the product">
    They pick a variant, add text or upload an image, and see it on the product as they go.
  </Step>

  <Step title="Submits and gets an ID">
    When they are happy, they click **Submit customization**. Mockspark saves the design and shows a 36-character ID with a copy button.

    <Frame>
      <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/guest-success-id.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=50f641f6c250e656f9d172739f93942c" alt="The confirmation screen showing the customization ID and a Copy button" width="1185" height="989" data-path="images/connections/etsy/guest-success-id.png" />
    </Frame>
  </Step>

  <Step title="Pastes the ID back on Etsy">
    They return to your listing, open **Add personalization**, paste the ID into the **Customization ID** box, and add to cart as normal. The character counter reads 36 of 36 when the ID is complete.

    <Frame>
      <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/etsy-personalization-filled.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=67777e7350b0bf243dc8a4fb5943ed16" alt="An Etsy listing with a customization ID pasted into the Customization ID field, the counter reading 36 of 36" width="1185" height="943" data-path="images/connections/etsy/etsy-personalization-filled.png" />
    </Frame>
  </Step>
</Steps>

When the order reaches Mockspark, it reads the ID, finds the design, and builds the print file from it. You do not need to match anything up by hand.

## When a Buyer Skips the ID

Some buyers will type a message into the field, or paste something that is not an ID, or buy without designing at all. Mockspark cannot produce anything in that case, so the order arrives marked **Unfulfillable** in your order list.

Open it and the page tells you exactly what went wrong and what the buyer actually typed, so you know whether they misread the instructions or skipped them.

<Frame>
  <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/order-unfulfillable.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=b0a9d272e852644df71ab2b76afb76e4" alt="An order that cannot be fulfilled, showing the reason and what the buyer typed into the personalization field" width="1185" height="945" data-path="images/connections/etsy/order-unfulfillable.png" />
</Frame>

You have a way out. Click **Copy redesign link**, then send that link to the buyer through Etsy messages. It opens the designer locked to the size they already paid for, so they cannot accidentally design for the wrong variant. Once they submit, the order becomes producible and moves on as normal.

<Frame>
  <img src="https://mintcdn.com/mockspark/hZY5sRDVr5EjIiPt/images/connections/etsy/order-redesign-link.png?fit=max&auto=format&n=hZY5sRDVr5EjIiPt&q=85&s=cb0219910afdb74d3e2b397ababe1970" alt="The What you can do next panel on a stalled order, with the Copy redesign link button" width="1175" height="936" data-path="images/connections/etsy/order-redesign-link.png" />
</Frame>

Nothing is charged for an order in this state. It sits on hold until the buyer supplies a design that matches what they ordered.

If the buyer never responds, click **Cancel order item** and refund them on Etsy. Cancelling in Mockspark only updates the status there, it does not refund anyone.

<Warning>
  Refunds always happen on Etsy. Mockspark never moves money and never contacts your buyers.
</Warning>

## Good Listing Copy Helps

Buyers move faster when the listing tells them what is coming. A line in your description such as "Click the link in the Personalization box to design your item, then paste the ID it gives you" cuts down on orders that arrive without an ID.

## Next

<Card title="Etsy Orders and Fulfillment" icon="package" href="/docs/connections/etsy/orders">
  How personalized and standard orders both get produced.
</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.
