Klaviyo Connect App

The Klaviyo Cloudinary integration lets you use your Cloudinary media, including dynamic, personalized image templates, directly in Klaviyo emails.

Overview

Klaviyo is a marketing automation platform for email and SMS campaigns. The Cloudinary integration for Klaviyo connects your cloud to Klaviyo and adds Cloudinary assets as Universal Content blocks.

The integration enables you to:

• Access and select Cloudinary assets directly within the Klaviyo email editor
• Reference assets as reusable Universal Content blocks without duplicating them into Klaviyo
• Personalize dynamic Cloudinary templates using Klaviyo profile attributes and event data
• Automatically keep every email up to date when you re-render an asset in Cloudinary
• Track which Universal Content blocks in Klaviyo reference a given Cloudinary asset

Use cases

Single source of truth for campaign assets

Save Cloudinary assets to Klaviyo as Universal Content blocks that reference the Cloudinary URL instead of copying the file into Klaviyo's image library. Re-rendering the asset in Cloudinary automatically updates every campaign and flow email that uses it.

Personalize visuals with customer data

Bind the text and image fields of a dynamic Cloudinary template (.cldt.json) to Klaviyo profile attributes or event data to personalize the visual for each recipient, then save the result as a Universal Content block. Recipients without matching personalization data see the template's default values.

Prerequisites

• A Cloudinary account with Media Library access (sign up for free if you don't have one).
• A Klaviyo account with permission to connect third-party apps.

Set up the integration

Connect Klaviyo to your Cloudinary account

1. Sign in to Cloudinary.
2. Click to open the Klaviyo Connect dialog box from Cloudinary's App Marketplace.
3. Click Enable.
4. Click Connect Cloudinary to Klaviyo, allowing pop-ups if prompted.
5. Approve the requested permissions in the Klaviyo sign-in window to:
   • Verify your account
   • Create and update Universal Content blocks
   • Upload to the Klaviyo image library (only used if you choose the copy-upload option when saving assets)
   • List the events you can personalize on (e.g., Placed Order, Added to Cart)
   • Read recent events to populate relevant event fields and product images

When you return to Cloudinary, the Setup tab shows that you're Connected.

Configure upload defaults

On the app's Setup tab, set the defaults applied whenever you save an asset to Klaviyo:

• Default image/video transformation: Select one from your image or video named transformations, respectively.
• Alt text source: Select the metadata option used as the alt text for assets you save to Klaviyo.

Use Cloudinary assets in Klaviyo

Save Cloudinary images, videos, and dynamic Cloudinary templates to Klaviyo, and add them as reusable Universal Content to your campaigns and flows.

Save assets to Klaviyo

Saving an asset to Klaviyo creates a Universal Content block that you can then add to any campaign or flow email.

1. In the Cloudinary Media Library, select one or more assets.
2. From the assets toolbar, choose Use in Klaviyo.

   

   Tip

   To manage a single asset in Klaviyo, select Use in Klaviyo from the (3-dots) options menu on its Manage page, or from the DAM Apps option in the asset's context menu.
3. In the Save to Klaviyo dialog box, optionally expand Delivery options to change the defaults:
   1. Select a storage option:
      • As Universal Content blocks (recommended), selected by default: references the Cloudinary URL without duplicating the asset, and updates automatically whenever you re-render the asset in Cloudinary.
      • Upload a copy to Klaviyo's image library: stores a separate copy in Klaviyo that no longer stays in sync with Cloudinary.
   2. Select a named transformation, or type a raw transformation string, to save variations of the selected assets in Klaviyo.
4. In the Save as-is section, click the Save ... to Klaviyo button. The label reflects how many assets you selected, for example Save 3 assets to Klaviyo, or Re-save to refresh for assets already saved.

   

Use Cloudinary content in campaigns and flows

Once you save a Cloudinary asset as a Universal Content block, add it to any campaign or flow email in Klaviyo like you would any other content block.

To add a Universal Content block to your email:

1. Edit a campaign or flow email in Klaviyo.
2. Click the Add content icon to add your Universal Content block to the email.

   

   Note

   If the Universal Content block contains a Cloudinary template that uses event variables to personalize its content, see Create personalized content with dynamic Cloudinary templates to see the full flow.
3. Drag the Universal Content block into your email where you want it to appear.
4. Preview the email with a profile, or send a test, to verify the content renders as expected.

To replace an existing asset with a Universal Content block:

1. Click the asset you want to replace and click the trash icon from its context menu.

   

2. Click the Add content icon to drag a Universal Content block into your email.

   

3. Drag the Universal Content block into the empty space.

   

Track assets saved to Klaviyo

To see where Klaviyo uses a Cloudinary asset, select one or more assets already saved in Klaviyo and open the Links to Klaviyo tab. It lists the Universal Content blocks that reference the selected assets, along with block thumbnails, block type, and whether the block still exists in Klaviyo. Use Open in Klaviyo to jump directly to a block.

Create personalized content with dynamic Cloudinary templates

Dynamic Cloudinary templates let you create personalized visual content for your Klaviyo emails. Connect the template's images, videos, and text to Klaviyo profile or event data, then save the template as a Universal Content block. When you use the block in a campaign or flow, its content changes based on each recipient's data.

Follow the instructions below to create a dynamic Cloudinary template in Figma and personalize it with Klaviyo data.

If you only want to save existing images, videos, or already-built templates to Klaviyo as-is, see Save assets to Klaviyo instead.

Create a dynamic Cloudinary template in Figma

Dynamic Cloudinary templates let you design once, then swap dynamic elements, such as images, videos, and text, for personalization.

Use the Cloudinary Figma Plugin to create a dynamic template, then save it to Cloudinary so you can personalize it with Klaviyo data.

1. Make sure your Figma plugin is open and connected.
2. Start with a design in Figma, for example the visual you want to send as a personalized abandoned cart or promotional image.
3. Select the frame or artboard you want to export, then select the Export Template tab.

   

4. Define which layers become dynamic fields, the parts that change per recipient, and which layers stay flattened into the background image.
5. Click Create template to save the template to your Cloudinary Media Library. Confirm uploading any custom fonts the design uses that aren't already in your Cloudinary account.

Personalize the template with Klaviyo data

Open the personalization panel from either Cloudinary or Klaviyo:

• From Cloudinary: In the Media Library, select a single dynamic template and select Use in Klaviyo (see Save assets to Klaviyo). The Personalize with Cloudinary dialog opens.
  Tip

  If it doesn't open by default, first click Personalize this template.

  

• From Klaviyo:
  Important

  Personalizing dynamic templates from within Klaviyo requires the Cloudinary Chrome Extension, which lets you personalize templates directly in Klaviyo, without switching to the Cloudinary Console.
  1. Edit the template's Universal Content block.
  2. In the left panel in the Image section, click Replace.
  3. Select the Dynamic image tab to personalize the selected Universal Content Block.

     

Once the panel is open:

1. Click Add event data (from Cloudinary) or Event (from Klaviyo).
2. Optionally Select an event to personalize against, such as Placed Order or Added to Cart. Selecting an event unlocks its fields, such as the ordered product's name or image, for binding in the next steps.
   Tip

   You don't need to select an event to bind fields to profile attributes, such as the recipient's first name.
3. For each text field:
   • Choose a fixed value, or type @ to select a profile attribute, an event field, or a coupon.
   • Click a text formatting button to shrink the text to fit, wrap it, or truncate it with an ellipsis.
4. For each image field:
   • Select Use template image, or, if your dynamic template is bound to an event, select Event image - Image URL.
   • Click the crop button to crop the image manually.
   • Select a crop option: Auto to let AI choose the best crop, Face to crop around detected faces, or one of the directional crops.
5. Review the live preview, which updates with sample values as you bind fields.
6. Click Save to Klaviyo to create the Universal Content block, and Update to Klaviyo if it's been saved before.

Use personalized content in a campaign or flow

1. Add the saved Universal Content block to a campaign or flow email.
   Important

   If you personalized against an event, send the email from a flow that matches the selected event so the event data is available.

   

2. Preview the email with a profile, or test data, that has matching attributes to check the personalization.
3. Send a test email to verify the personalization renders correctly for different recipients.

Use the Cloudinary Chrome Extension

The Cloudinary Chrome Extension lets you select, save, and personalize Cloudinary assets directly in the Klaviyo email editor, without switching back to the Cloudinary Console.

Install the extension

1. Install the Cloudinary Chrome Extension from the Chrome Web Store, or click Add to Chrome on the extension card in the app's Setup tab.
2. Confirm the extension is active: once you install and enable it, the app's Setup tab shows an Extension active badge.

Use Cloudinary from the Klaviyo editor

When designing a campaign or flow email in the Klaviyo email editor, look for Cloudinary controls on image blocks, link blocks, and Universal Content HTML blocks.

You can use the Cloudinary Chrome Extension to add or replace images and videos in the following fields.

Add a dynamic Cloudinary template

1. Click the Add content icon and add a Basic image block.
2. Click Select image.
3. Select the Dynamic image tab in the dialog box.
4. Click the Cloudinary Chrome Extension icon to open the Cloudinary asset picker and Pick a template to import.

   

5. Personalize the template (see Personalize the template with Klaviyo data).
6. Click Save.

Add video content

1. Click the Add content icon and add a Basic video block.
2. Click the Cloudinary Chrome Extension icon to open the Cloudinary asset picker and select the video you want to import.

   

Troubleshooting

Cloudinary Professional Services configuration support

The Klaviyo integration is part of Cloudinary's Standard Professional Services integration configuration package.

If you need assistance setting up this integration and you're on an Enterprise plan with a professional services package in your contract, Cloudinary's professional services can help you set it up as part of your contracted package.

Learn more: Cloudinary Professional Services packages