- Unsubscribe
{% unsubscribe %} (or <a href="{% unsubscribe_link %}">Unsubscribe</a>)- First name
{{ first_name }}(Django template language)- With a fallback
{{ first_name|default:'there' }}- View in browser
{% web_view %} (or {% web_view_link %} for the address only)- Preferences
{% manage_preferences %}- Postal address
{{ organization.full_address }}
The Klaviyo unsubscribe link
Put this in the footer of every marketing email you code for Klaviyo:
{% unsubscribe %} (or <a href="{% unsubscribe_link %}">Unsubscribe</a>)
- Marketing templates must include {% unsubscribe %} or {% unsubscribe_link %}.
The law in most countries also wants the unsubscribe to be easy to find and free to use: see the email rules by country.
Personalisation in Klaviyo: first name with a fallback
Klaviyo uses Django template language. A first name on its own:
{{ first_name }}
With a fallback, so an empty field never shows a blank or a raw tag:
{{ first_name|default:'there' }}
Showing something only to some people (an if / else):
{% if person|lookup:'Loyalty Points' > 0 %}You have points{% else %}Join the club{% endif %}
View in browser, preferences and address tags
- View in browser:
{% web_view %} (or {% web_view_link %} for the address only) - Preferences:
{% manage_preferences %} - Postal address:
{{ organization.full_address }}
Making a coded template editable in Klaviyo
A hybrid template: each <td data-klaviyo-region="true"> is one drag-and-drop region (width in pixels); klaviyo-block divs inside it start as text or image blocks. The HTML around the regions stays fixed.
<tr><td align="center" data-klaviyo-region="true" data-klaviyo-region-width-pixels="600"><div class="klaviyo-block klaviyo-text-block">Hello world!</div></td></tr>
Getting your HTML into Klaviyo
Content > Templates > Import: name it and upload the .html file, with a ZIP of local images under "Upload additional files". Images are moved to Klaviyo's CDN and the references updated.
Limits worth knowing
- Uploads must be .html files; each image 10 MB or smaller.
- Image paths in the ZIP must match the references in the HTML exactly.
- Tags from other platforms are not supported and must be replaced before import.
What Klaviyo calls things
Every platform has its own words for the same ideas. Klaviyo's, in plain English:
| The idea | Klaviyo calls it | Worth knowing |
|---|---|---|
| One-off send | Campaign | A one-time message sent to a chosen list or segment at a time you schedule. Campaigns batch-send; flows send per profile. Not interchangeable. |
| Automated journey | Flow | An automated sequence of steps set in motion by a single trigger. Flows also update properties and fire webhooks, not just send. |
| Trigger / entry | Flow trigger | The event, list join, segment join, date property or price drop that starts a flow. One trigger per flow. Entry restrictions are separate flow and trigger filters. |
| Static group | List | A collection of profiles added by form, integration, API or manual upload. Not truly static, people unsubscribe out, and suppressed profiles still appear on it. |
| Dynamic group | Segment | A group defined by conditions that adds and removes profiles automatically. Segments cannot collect consent, only lists can. |
| Customer record | Profile | The record for one contact: properties, consent status and full activity feed. “Active profile” is a billing term and won’t match your list counts. |
| Custom field | Profile property | A field you create to store extra information, such as size or birthday. Properties with spaces or $ need lookup notation, not dot notation. |
| Behavioural event | Metric | An action someone takes, such as Placed Order, used for segmenting and triggering. “Metric” means an event type here, not a performance statistic. |
| Reusable block | Universal content | A block saved once and reused across templates, with edits propagating everywhere. Saved content is an unlinked copy; universal content stays linked. |
| Template | Email template | The saved contents of an email, usable in a campaign or flow message. Editing a template does not update messages already built from it. |
| Personalisation language | Django template language | Klaviyo personalises using Django syntax: {{ variables }}, {% tags %} and filters. Django, not Liquid, Jinja or Handlebars. Variables cannot contain spaces or hyphens. |
| Fallback value | default filter | A template filter supplying placeholder text when a variable is empty. Filter order matters, filters before default don’t affect the fallback. |
| A/B test | A/B test (variations) | Comparing message variations on open or click rate. “Winning variation” sends one winner; “personalized variations” picks per recipient. |
| Suppression | Suppressed / suppression list | A profile blocked from email marketing after unsubscribing, hard bouncing or manual addition. Suppression is global and separate from consent, suppressed people still show on lists. |
| Frequency capping | Smart Sending | Skips anyone who already received a message on that channel within a recent window. The closest thing to frequency capping. Defaults: 16 hours email, 24 SMS. |
| Transactional | Transactional designation | A per-message setting for user-triggered informational emails containing no marketing content. Set per message, only in metric-triggered flows, and needs Klaviyo approval. |
| Preference centre | Manage preferences page | A hosted page where recipients choose which messages they want. List-specific pages only apply to single-list campaigns. |
| Send-time optimisation | Smart Send Time | Finds one best hour for your audience; Personalized send time optimises per recipient. Easily confused with Smart Sending, a completely unrelated feature. |
| Reporting | Analytics | Custom reports, dashboards and Benchmarks. Benchmarks compares you against similar companies, not your own past performance. |
| Imported data table | Custom objects | Multi-field records imported into Klaviyo; product data uses Catalog instead. Requires Advanced Klaviyo Data Platform, billed separately. |
| API-triggered send | Create Event API | You post an event, which triggers a flow. Flows can also push webhooks out. There is no “send this email now” API. |
| Draft vs live | Draft / Manual / Live | Draft never sends, Manual queues for human review, Live sends automatically. Status is per message, a live flow full of draft messages sends nothing. |
What we couldn't confirm
We only list what Klaviyo's documentation says. These points weren't clear from it, so test them in your account:
- Whether Klaviyo inlines CSS from <style> blocks in imported HTML was not stated in the docs read.
Questions
What is the unsubscribe tag in Klaviyo?
{% unsubscribe %} (or {% unsubscribe_link %}). Marketing templates must include {% unsubscribe %} or {% unsubscribe_link %}.
How do I add a first name with a fallback in Klaviyo?
Klaviyo uses Django template language. A first name is {{ first_name }}, and with a fallback: {{ first_name|default:'there' }}
How do I add a view-in-browser link in Klaviyo?
Use {% web_view %} (or {% web_view_link %} for the address only).
How do I get a custom HTML email into Klaviyo?
Content > Templates > Import: name it and upload the .html file, with a ZIP of local images under "Upload additional files". Images are moved to Klaviyo's CDN and the references updated.
Sources
- help.klaviyo.com/hc/en-us/articles/4408802648731
- help.klaviyo.com/hc/en-us/articles/115005254068
- help.klaviyo.com/hc/en-us/articles/115005254188
- help.klaviyo.com/hc/en-us/articles/115002774932 (terms)
Checked by Mailfois against Klaviyo's documentation on 27 October 2026. Platforms rename things often: spotted something out of date? Email [email protected].
Other platforms
Mailchimp · HubSpot Marketing Hub · Salesforce Marketing Cloud Engagement · Braze · Adobe Marketo Engage · Bloomreach Engagement · Brevo · Constant Contact · Campaign Monitor · Dotdigital · Iterable · Resend