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

# Klaviyo

> Export HTML, hybrid editable templates or native Klaviyo blocks, connect a send-time product feed, and update a verified template.

Builder can create and update Klaviyo templates in three formats. **Native drag-and-drop** is available to all connected Klaviyo accounts, subject to your Builder role and plan.

## Connect Klaviyo

1. Create a Klaviyo **private API key** with permission to read and write templates. A public site ID cannot export templates.
2. In Builder, open **Integrations > Klaviyo** as a workspace owner or admin.
3. Enter the private API key and save.

See [Klaviyo's private API key guide](https://help.klaviyo.com/hc/en-us/articles/7423954176283) for creating a scoped key. If you connect more than one account, give each a recognizable name.

![Klaviyo connection form in Builder](https://mintcdn.com/emaillove/qYrzRKTscc4O0qPw/images/builder/guides/connect-klaviyo.jpg?fit=max\&auto=format\&n=qYrzRKTscc4O0qPw\&q=85\&s=ffaddd3a7ac1e75632cee6010feed5a5)

Connect Klaviyo in Integrations before exporting. This example shows blank connection fields; use the credentials for your account.

## Choose an export format

Open the email, click **Export**, select the Klaviyo account, and choose **Editing in Klaviyo**.

| Format | Use it when | Editing in Klaviyo |
| - | - | - |
| **HTML code** | You want the compiled Builder layout | Edit the HTML |
| **Hybrid: editable text and images** | You want the layout with editable content regions | Edit supported text and images after using the template in a campaign or flow |
| **Native drag-and-drop** | You need native blocks or a send-time product feed | Edit supported Klaviyo blocks in its native editor |

Hybrid templates are HTML with editable regions, not fully native block templates. Opening one in the standalone template library may show code. Use it in a campaign or flow to access the editable regions. Personalized images remain HTML.

Native export supports text, buttons, rules, spacers, supported columns, dynamic images and product-feed blocks. Klaviyo controls the responsive and dark-mode rendering, so review both after export.

> [!NOTE]
>
> Ordinary static images cannot currently be imported as native Klaviyo image-library blocks. Use **Hybrid: editable text and images** or **HTML code** for those designs. Unsupported raw code, conditional structures, layouts or custom phone overrides can also stop native export. Builder reports the problem instead of silently dropping the content.

Click **Export to Klaviyo**. After success, open the template in Klaviyo and check its layout, links and personalization.

## Use products selected at send time

This uses an existing dynamic product feed in Klaviyo. It is different from inserting a fixed product selection while designing in Builder.

1. In Klaviyo, configure a dynamic product block in a native template in the account you will export to.
2. In Builder, add **Klaviyo product feed** from **Blocks** to a layout column.
3. Under **Products at send time**, select the **Klaviyo account** and enter the **Source native template ID**.
4. Click **Load product feeds**, then choose the **Product block**.
5. Set the available rows, columns, product titles, prices and button options. A fixed design may lock structural choices.
6. Export using **Native drag-and-drop** to that same account.

Builder shows a placeholder. Klaviyo selects the products when the message is sent. Preview the actual product selection in Klaviyo.

The source template and product block must still exist when you export. Builder checks that reference again. If it was removed or belongs to a different account, choose a valid source before exporting. Saving an unconnected product-feed block in Builder does not make it exportable.

## Update a template

Export the same Builder email to the same account and choose **Update the template**. Builder checks the destination against its last verified export and reads the result back after saving.

* If the template changed in Klaviyo, the update stops for review.
* If the content is already up to date, Builder reports that no export allowance was used.
* The existing editing format stays fixed. Choose **Create a new template** to switch between HTML, hybrid and native formats.
* An older export without a verified destination may require a new copy.

Creating a new template leaves the earlier one intact. Changes made in Klaviyo do not sync back into Builder.

## Campaign and flow settings

The export creates or updates the selected template. It does not update existing campaign or flow copies, choose an audience, schedule a message or send it.

Set the subject, preview text, sender and other message settings in your Klaviyo campaign or flow. Test personalization and the product feed there before sending.

## Troubleshooting

| What you see | What to do |
| - | - |
| Native export cannot preserve an image or layout | Use hybrid or HTML, or replace the unsupported block. Static image-library import is not supported in native mode yet. |
| No product blocks found | Confirm the source is a native Klaviyo template with a dynamic product block in the selected account. |
| The product feed is unbound or its source changed | Load the source template again and select a valid product block. |
| The destination changed in Klaviyo | Keep editing that version there, or create a new template from Builder. |
| You only see HTML for a hybrid template | Use the template in a campaign or flow to edit its supported regions. |
| The outcome is uncertain | Check delivery status and Klaviyo before starting another export. Contact Email Love if the attempt stays unresolved. |

See [verified updates and delivery status](https://help.emaillove.com/builder/sending/esps.md#verified-updates-and-delivery-status) for more on updates and recovery.

## Connection and reporting

See the [Klaviyo integration guide](https://help.emaillove.com/builder/integrations/klaviyo.md) for connection setup and current aggregate reporting support. For the shared Reports and AI workflow, see [Email insights and reporting](https://help.emaillove.com/builder/reports/email-insights.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.