---
title: "Show the Buyer's Design in Klaviyo Emails | Help center | Customix"
description: "Show the buyer's personalized design in Klaviyo emails with template code, and send a Customix Personalized Order event to Klaviyo for flows and segments."
url: https://customix.io/help/klaviyo-email-design-images
language: en
---

# Show the Buyer's Design in Klaviyo Emails

Show the buyer's personalized design in Klaviyo emails with template code, and send a Customix Personalized Order event to Klaviyo for flows and segments.

Updated Nov 20, 2026

Klaviyo's abandoned checkout, order confirmation and shipping emails show the product image, not what the buyer personalized. Customix already saves the design on every order line, and Klaviyo syncs it from Shopify. Paste a short piece of template code into your Klaviyo emails and each line shows:

- the buyer's design image (or the product image when the line has no design);
- the options the buyer chose (technical fields are hidden; uploaded photos become a **View image** link);
- a link that reopens the saved design on the product page, on any device.

![Klaviyo order confirmation preview with two personalized cups showing the design image](https://cdn.sanity.io/images/30j60knw/production/63b455aa9b744d2f81f46a1e34fcd758f74d5572-1202x920.png?w=1202&fit=max&auto=format)

## Before you start

- Klaviyo is connected to your Shopify store (**Klaviyo > Integrations > Shopify**).
- The email belongs to a flow triggered by one of these Shopify events: **Checkout Started** (abandoned checkout), **Placed Order** (order confirmation) or **Fulfilled Order** (shipping). These events carry the order lines.
- **Added to Cart** carries no order lines in Klaviyo, so the code doesn't work in Added to Cart flows.

You'll find the code in the Customix app: **Settings > Integrations > Klaviyo**, card **Email template code**, with a **Copy** button for each piece.

## Option 1: add the order lines block

Use this when your email doesn't list the products yet, or you want to replace the list.

1. In Klaviyo, open the flow email and click **Edit**.
2. Drag an **HTML** block where the products should appear.
3. Paste the **Order lines with design images** code:

```
{% for item in event.extra.line_items %}
<table width="100%" cellpadding="0" cellspacing="0" border="0" role="presentation"><tr>
<td width="120" valign="top" style="padding:12px 0;"><img src="{% if item.product.properties|lookup:'_cm-thumb-url' %}{{ item.product.properties|lookup:'_cm-thumb-url' }}{% else %}{% if item.product.variant.images.0.src %}{{ item.product.variant.images.0.src }}{% else %}{{ item.product.images.0.src|missing_product_image }}{% endif %}{% endif %}" width="120" alt="{{ item.title }}" style="display:block;width:120px;max-width:120px;height:auto;border:0;border-radius:8px;"></td>
<td valign="top" style="padding:12px 0 12px 16px;font-family:Arial,Helvetica,sans-serif;font-size:14px;line-height:20px;color:#202223;">
<strong>{{ item.title }}</strong><br>
{% if item.variant_title %}{{ item.variant_title }}<br>{% endif %}
{% for prop in item.properties %}{% if prop.value and prop.name|slice:":1" != "_" %}{{ prop.name }}: {% if prop.value|slice:":8" == "https://" %}<a href="{{ prop.value }}" style="color:#2c6ecb;">View image</a>{% else %}{{ prop.value }}{% endif %}<br>{% endif %}{% endfor %}
Qty: {{ item.quantity|floatformat:0 }}
{% if item.product.properties|lookup:'_cm-customization-url' %}<br><a href="{{ item.product.properties|lookup:'_cm-customization-url' }}" style="color:#2c6ecb;text-decoration:underline;">View your design</a>{% endif %}
</td>
</tr></table>
{% endfor %}
```

You can change the words "Qty", "View image" and "View your design", the colors and the image width (120) to match your email. In an abandoned checkout email, "Finish your design" often reads better than "View your design".

![Klaviyo abandoned checkout preview on mobile with the design image and a Finish your design link](https://cdn.sanity.io/images/30j60knw/production/9aa6da2282d5a604f3431db53ca13d43ec6f0914-808x476.png?w=1100&fit=max&auto=format)

## Option 2: keep your product table, change its image

Use this when your email already lists the products in a table block with dynamic rows (row alias `item`, the Klaviyo default).

1. Select the product image of the row.
2. Set its image URL (dynamic image) to the **Design image URL** code:

```
{% if item.product.properties|lookup:'_cm-thumb-url' %}{{ item.product.properties|lookup:'_cm-thumb-url' }}{% else %}{% if item.product.variant.images.0.src %}{{ item.product.variant.images.0.src }}{% else %}{{ item.product.images.0.src|missing_product_image }}{% endif %}{% endif %}
```

1. To add the link back to the design, paste the **Design link** code in the row's text:

```
{% if item.product.properties|lookup:'_cm-customization-url' %}<a href="{{ item.product.properties|lookup:'_cm-customization-url' }}">View your design</a>{% endif %}
```

If your rows use another alias than `item`, replace `item.` with yours.

## Preview before you turn the flow on

In the email editor, click **Preview** and pick a recent event (Klaviyo lists the last 10). Personalized lines show the design image; other lines show the product image.

## Good to know

- **No design image?** If the design image couldn't be saved when the buyer added the product to the cart, the line shows the product image. Nothing breaks.
- **Add-ons and bundles:** add-on items and the items of a bundle show as their own lines, each with its own design.
- **Hidden fields:** order lines also carry technical fields whose names start with `_cm-` (print files, ids). The code never shows them.
- **Where the images live:** design images are public images on cdn.customix.io (JPEG, about 1000–1200 px, around 100 KB), so email clients can load them.
- **Privacy:** The template code needs no connection: Klaviyo reads the order from Shopify. Customix sends its own event only after you connect a Klaviyo key, for orders placed from then on.

## Send personalized orders to Klaviyo

Connect your Klaviyo account and Customix sends a **Customix Personalized Order** event for every order with a design: the design image, the link to the design and the options the buyer chose. Use it to start flows (a thank-you email that shows the design, a reorder reminder) and to build segments of buyers who personalize.

### 1\. Create a private API key in Klaviyo

1. In Klaviyo, open **Settings > API keys** (Account > Settings > API keys).
2. Under **Private API Keys**, click **Create Private API Key**.
3. Name it, for example `Customix`.
4. Choose **Custom Key**, set **Accounts** to Read Access and **Events** to Full Access, and leave everything else on No Access.
5. Click **Create**, then copy the key right away. It starts with `pk_`.

Keep the key private: anyone who has it can write to your Klaviyo account. Don't send it by email or chat; paste it only in the Customix app.

### 2\. Connect it in Customix

Only the store owner can connect, replace or disconnect Klaviyo: the key decides which Klaviyo account receives your buyers' orders. Staff see a note instead of the form.

1. In the Customix app, open **Settings > Integrations > Klaviyo**.
2. In the **Send orders to Klaviyo** card, paste the key in **Private API key** and click **Connect**.
3. Customix checks the key with Klaviyo before saving it. The card then shows **Connected to {your Klaviyo account}**, the key's last four characters, and when the last order was sent.

If Klaviyo refuses the key, the card says so under the field. Check that it is a private key (`pk_…`) with Accounts (read) and Events (full) access.

From then on, every new order with a design is sent within a few minutes. Orders placed before you connected are not sent.

### What the event contains

The event **Customix Personalized Order** is sent once per order, only for orders with at least one design. Its properties:

- `OrderNumber`, `OrderId`: the Shopify order name (#1001) and id.
- `ProductName`, `ImageURL`, `DesignURL`: the first personalized line: product, design image and the link that reopens the design.
- `ItemNames`, `ItemCount`: the personalized lines.
- `Items`: every personalized line, with `ProductName`, `VariantName`, `ProductID`, `VariantID`, `SKU`, `Quantity`, `ItemPrice`, `ImageURL`, `DesignURL`, `CustomizationID` and `Options` (the options the buyer chose, by name).
- The event value is the order total, in the order's currency.

Example in a flow email triggered by the event:

```
<img src="{{ event.ImageURL }}" width="300" alt="{{ event.ProductName }}">
<a href="{{ event.DesignURL }}">View your design</a>

{% for item in event.Items %}
  <img src="{{ item.ImageURL }}" width="120"> {{ item.ProductName }} × {{ item.Quantity }}
{% endfor %}
```

The buyer's Klaviyo profile also gets these properties, handy for segments and later emails:

- `Customix Last Personalized Product`
- `Customix Last Design Image`
- `Customix Last Design URL`
- `Customix Last Personalized Order At`

### Ideas

- **Thank-you flow** triggered by Customix Personalized Order, showing `event.ImageURL`.
- **Segment** "What someone has done: Customix Personalized Order at least once" for buyers who personalize.
- **Reorder or gift reminder** before the anniversary of `Customix Last Personalized Order At`, showing `person|lookup:'Customix Last Design Image'`.

### Photos buyers uploaded

**Send the photos buyers uploaded** is off by default, because a photo may show a person. When it's on, the links to the photos are sent with the options. The design image is always sent: it shows the photo only as printed on the product.

### About the connection

- Customix sends to your own Klaviyo account only, with your key. Click **Disconnect** at any time; events already sent stay in Klaviyo. Uninstalling Customix also deletes the key.
- Shopify sometimes delivers an order twice; Klaviyo keeps one event per order.
- The event doesn't change anyone's email or SMS consent. Klaviyo only emails people who can receive marketing, as with any flow.
- An order without the buyer's email isn't sent, because Klaviyo needs a profile.
- If Klaviyo stops accepting the key (deleted, scopes changed), the card shows **Needs attention** with Klaviyo's reason. Click **Replace key** to paste a new one.

## Still need help?

Our support team will walk you through it. Email us or book a call with the team.

[Email support →](mailto:support@customix.io?subject=Customix%20support)[Book a call](https://calendly.com/customix-support/30min)
