HubSpot
Email marketing. A Piksio image goes into HubSpot 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”HubSpot writes merge tags like {{ contact.firstname }}.
In image links Piksio uses the URL-encoding form, {{ contact.company|urlencode }}, so a value like “Smith & Co” stays intact.
Built-in fields
Section titled “Built-in fields”Piksio maps these to HubSpot’s own fields automatically:
| Piksio field | HubSpot field |
|---|---|
first_name |
contact.firstname |
last_name |
contact.lastname |
company_name |
contact.company |
Custom fields
Section titled “Custom fields”Any other field must exist in HubSpot before you send. Settings → Properties → Contact properties → Create property. Use its internal name here, not its label.
HubSpot’s guide to custom fields
Where to paste
Section titled “Where to paste”Add a Rich text module, open Advanced → Source code, and paste the HTML.
Formats offered: Image URL, HTML. The default for HubSpot is HTML.
Example
Section titled “Example”For a design with first_name and company_name, the HTML looks like this:
<img src="https://app.piksio.com/i/YOUR_IMAGE_ID?first_name={{ contact.firstname|urlencode }}&company_name={{ contact.company|urlencode }}" width="600" alt="Your personalized image" style="display:block;max-width:100%;height:auto;border:0" />Good to know
Section titled “Good to know”- Use the property’s internal name (lowercase, no spaces), not its label.
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 HubSpot 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 HubSpot’s own documentation on 2026-10-07: