Skip to content

Klaviyo

Email marketing. A Piksio image goes into Klaviyo as an ordinary image link. The platform fills in each recipient’s values, and Piksio renders their version when the email is opened.

Klaviyo writes merge tags like {{ first_name }}.

In image links Piksio uses the URL-encoding form, {{ organization|urlencode }}, so a value like “Smith & Co” stays intact.

Piksio maps these to Klaviyo’s own fields automatically:

Piksio field Klaviyo field
first_name first_name
last_name last_name
company_name organization

Any other field must exist in Klaviyo before you send. Klaviyo creates a custom profile property when your list import or sync includes it. The name must match exactly, including capitals and spaces.

Klaviyo’s guide to custom fields

Add an Image block, choose Select image → Dynamic image, and paste into “Dynamic variable or dynamic URL”.

Formats offered: Image URL, HTML. The default for Klaviyo is Image URL.

For a design with first_name and company_name, the Image URL looks like this:

https://app.piksio.com/i/YOUR_IMAGE_ID?first_name={{ first_name|urlencode }}&company_name={{ organization|urlencode }}
  • Campaigns and non-metric flows can only use profile properties, not event data.
  1. In Use in email, use Test the link with sample values, and again with unfilled tags. Both are free.
  2. Preview one real recipient in Klaviyo to confirm it fills in the fields.
  3. See Fallbacks and blanks for what a recipient with missing data sees.

Checked against Klaviyo’s own documentation on 2026-10-07: