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.
Merge tags
Section titled “Merge tags”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.
Built-in fields
Section titled “Built-in fields”Piksio maps these to Klaviyo’s own fields automatically:
| Piksio field | Klaviyo field |
|---|---|
first_name |
first_name |
last_name |
last_name |
company_name |
organization |
Custom fields
Section titled “Custom fields”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
Where to paste
Section titled “Where to paste”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.
Example
Section titled “Example”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 }}Good to know
Section titled “Good to know”- Campaigns and non-metric flows can only use profile properties, not event data.
Check before you send
Section titled “Check before you send”- In Use in email, use Test the link with sample values, and again with unfilled tags. Both are free.
- Preview one real recipient in Klaviyo to confirm it fills in the fields.
- See Fallbacks and blanks for what a recipient with missing data sees.
Sources
Section titled “Sources”Checked against Klaviyo’s own documentation on 2026-10-07: