Gids voor personalisatie van berichten

Ongeveer 16 minuten lezen

Bijgewerkt 8 aug 2025, 09:38 EST

Leer hoe je Klaviyo-templatetags gebruikt in je marketingberichten en Klaviyo Customer Hub om je abonnees een aangepaste ervaring te bieden.pla

Je kunt personalisatietags gebruiken in e-mails (inclusief de onderwerpregel van de e-mail), sms/mms-berichten, pushmeldingen en Klaviyo Customer Hub. Dit artikel beschrijft bepaalde beschikbare tags, hun structuren en vormen en hoe je ze kunt aanpassen. Om te leren hoe je personalisatie toevoegt, ga je naar ons artikel over personalisatie toevoegen aan je berichten.

Personalisatietags werden eerder ook wel variabele syntax genoemd.

Over personalisatietags

Wanneer je tags invoert in een tekstveld, zien ze eruit zoals de zin links in de onderstaande tabel. Zodra het bericht wordt weergegeven, wordt de tag vervangen door informatie uit het profiel of de gebeurtenisgegevens van de ontvanger en ziet deze eruit als de zin rechts.

Hallo {{ first_name }} {{ last_name }}, je favoriete kleur is {{ person|lookup:'Favorite Color' }}

Hallo George Washington, je favoriete kleur is groen

Profielpersonalisatie begint over het algemeen met person, met uitzondering van een paar speciale tags zoals first_name en last_name. Gebeurtenisvariabelen, die gebruikt kunnen worden in door meetwaarden getriggerde flows, beginnen met event. Organisatietags (zoals je bedrijfsnaam en -adres) beginnen met organization.

Alle personalisatietags zijn hoofdlettergevoelig en moeten exact overeenkomen met de namen van de eigenschappen waarnaar ze verwijzen. Zorg ervoor dat je tag correct gespeld is en gebruik dezelfde hoofd- en kleine letters als voor je profielen.

Profielpersonalisatie

Als je profielpersonalisatie inschakelt, kun je in je berichten speciale Klaviyo-eigenschappen weergeven. De onderstaande lijst heeft betrekking op alle profielpersonalisaties(d.w.z. ingebouwde Klaviyo-eigenschappen). Bepaalde profielpersonalisatietags zijn beschikbaar in het menu Personalisatie in de e-maileditor of in het voorbeeldvenster voor sms- en pushberichten.

Als je aangepaste eigenschappen aan je berichten wilt toevoegen, ga dan naar het gedeelte over aangepaste personalisatie.

Tag	Profieleigenschap
`{{ email }}`	E-mail
`{{ first_name }}`	Voornaam
`{{ last_name }}`	Achternaam
`{{ person.organization }}`	Organisatie van ontvanger
`{{ person\|lookup:"$address1" }}`	Adres 1
`{{ person.id }}`	Unieke ID ($id/externe ID)
`{{ person\|lookup:"$latitude" }}`	Breedtegraad
`{{ person\|lookup:"$longitude" }}`	Lengtegraad
`{{ person.KlaviyoID }}`	Klaviyo-ID
`{{ person.full_name }}`	Volledige naam
`{{ person.title }}`	Titel
`{{ person.phone_number }}`	Telefoonnummer
`{{ person\|lookup:'$address2' }}`	Adres 2
`{{ person.City }}`	Plaats
`{{ person.Region }}`	Staat/regio
`{{ person.Country }}`	Land
`{{ person.Zipcode }}`	Postcode
`{{ person\|lookup:"$source" }}`	Bron
`{{ person\|lookup:"$consent" }}`	Toestemming
`{{ person\|lookup:'$consent_form_id' }}`	$consent_form_id
`{{ person\|lookup:'$consent_form_version' }}`	$consent_form_version
`{{ person\|lookup:'$consent_method' }}`	$consent_method
`{{ person\|lookup:"$timezone" }}`	Tijdzone ontvanger
`{{ person\|lookup:'$consent_timestamp' }}`	$consent_timestamp
`{{ person\|lookup:'$phone_number_region' }}`	$phone_number_region
`{{ person.ViewedItems }}`	Onlangs bekeken items
`{{ person\|lookup:"Expected Date Of Next Order" }}`	Verwachte datum van volgende bestelling

Aangepaste objecttags

Met aangepaste objecttags kun je objectgegevens gebruiken in flow- en campagneverzendingen.

Bekijk tagreferenties voor specifieke voorbeelden van hoe je tags gebruikt voor het ophalen van een object-ID of weergeven van een telling.

Je moet eerst een object maken voordat je aangepaste objectgegevens in templates kunt gebruiken. De tag {{ object }} is alleen beschikbaar als een object een flow heeft getriggerd.

Tag	Resultaat
`{{ object.object_property }}`	Geeft het object weer dat een flow heeft getriggerd
`{{ object \| lookup:'object_property' }}`	Geeft het object weer dat een flow heeft getriggerd
`{{ object_filter.object_filter_name.object_property}}`	Geeft een enkel object weer uit een objectfilter
`{{ object_filter.object_filter_name \| lookup: 'object_property' }}`	Geeft een enkel object weer uit een objectfilter
`{{ object_filter.object_filter_name }}`	Geeft een telling van een objectfilter weer
`{% customobject id={{ event.object_id }} als alias %}`	Een object op ID ophalen
`{% customobjects object_type_title=“Title” as alias %} {% for object_instance in alias %} {{ object_instance.record }} {% endfor %} {% endcustomobjects %}`	Haalt alle rapporten voor een object uit één profiel op

Organisatietags

Met organisatietags kun je informatie over je bedrijf of organisatie in je berichten opnemen. Je kunt deze informatie beheren door op de naam van je organisatie in de linkeronderhoek te klikken en vervolgens Instellingen > Organisatie > Contactgegevens te selecteren. Alle organisatietags beginnen met organisatie. Zie de onderstaande tabel voor de lijst met organisatietags.

Organisatietag	Beschrijving
`{{ organization.name }}`	Naam van je organisatie
`{{ organization.url }}`	De website van je organisatie
`{{ organization.full_address }}`	Het volledige adres van je organisatie, inclusief plaats, staat/regio en postcode
`{{ organization.street_address }}`	Het adres van je organisatie
`{{ organization.street_address2 }}`	Een tweede regel van het organisatieadres (bijv. het nummer van het appartement of de unit)
`{{ organization.city }}`	De plaats van je organisatie
`{{ organization.region }}`	De staat, provincie of regio van je organisatie
`{{ organization.zip_code }}`	Postcode van je organisatie

Tags voor links en voorbeeldweergaven

Met de tags voor links en voorbeeldweergaven kunnen ontvangers hun abonnementsvoorkeuren beheren en je bericht in hun browser bekijken. Deze omvatten:

Afmelden
Voorkeuren beheren
Webweergave
Voorbeeldweergave van de tekst

Deze tags worden alleen ondersteund voor e-mailtemplates. Als je op een van deze links klikt vanuit een voorbeeldmail, word je doorgestuurd naar een tijdelijke pagina in plaats van een live toestemmingspagina of voorbeeldweergave.

Afmelden

Klaviyo vereist een afmeldlink in elke e-mail. Gebruik een eenvoudige afmeldingstag voor een link met de tekst 'Afmelden', of voeg je eigen tekst toe tussen aanhalingstekens.

Tag	Uitvoer
`{% unsubscribe %}`	Afmelden
Als je geen e-mails meer wilt ontvangen, `{% unsubscribe 'click here' %}`.	Als je geen e-mails meer wilt ontvangen, klik dan hier.

Je kunt ook de tag {% unsubscribe_link %} gebruiken om een afmeldings-URL te maken. In plaats van een volledig gelinkt woord of zinsdeel te genereren, maakt deze tag alleen de afmeldings-URL. Gebruik deze tag als je een andere kleur wilt gebruiken voor je afmeldingslink dan de linkkleur die is ingesteld in de stijlen van je templates, of als je een gekoppelde knop of afbeelding in plaats van een tekstlink wilt gebruiken.

Tag	Uitvoer
`Dit is een speciale <a href="{% unsubscribe_link %}" >afmeldlink</a>.`	Dit is een speciale afmeldlink.

Als ontvangers op de afmeldlink klikken, worden ze naar een aanpasbare bevestigingspagina geleid.

Voorkeuren beheren

Voorkeurpagina's stellen ontvangers in staat om hun voorkeuren bij te werken, zodat je gerichter berichten kunt sturen op basis van segmenten. Gebruik de tag Voorkeuren beheren om een link naar deze pagina op te nemen voor elke ontvanger.

Je kunt lijstspecifieke en algemene pagina's voor voorkeuren beheren maken. Lijstspecifieke pagina's worden verzonden wanneer je een bericht naar een enkele lijst stuurt. De algemene pagina Voorkeuren beheren wordt gebruikt wanneer je verzendt naar een segment of een combinatie van lijsten, en in flows die niet door een lijst worden getriggerd. Meer informatie over pagina's voor het beheren van voorkeuren.

Gebruik een eenvoudige Voorkeuren beheren-tag voor een link met de tekst 'Voorkeuren beheren' of voeg je eigen tekst toe tussen aanhalingstekens.

Tag	Uitvoer
`{% manage_preferences %}`	Voorkeuren beheren
Wil je je voorkeuren bijwerken? `{% manage_preferences 'Click here' %}`.	Wil je je voorkeuren bijwerken? Klik hier.

Je kunt ook de tag {% manage_preferences_link %} gebruiken om een URL voor het beheren van voorkeuren te genereren. In plaats van een volledig gelinkt woord of zinsdeel te genereren, maakt deze tag alleen de URL voor de voorkeurspagina van de ontvanger. Gebruik deze tag als je een andere kleur voor je link wilt gebruiken dan de linkkleur die is ingesteld in de stijlen van je templates, of als je een gekoppelde knop of afbeelding wilt gebruiken in plaats van een tekstlink.

Tag	Uitvoer
`Dit is een speciale link voor <a href="{% manage_preferences_link %}" >voorkeuren beheren</a>.`	Dit is een speciale link voor voorkeuren beheren.

Webweergave

Om ontvangers de optie te geven om een e-mail in hun webbrowser te bekijken, kun je de tag Webweergave gebruiken.

Tag	Uitvoer
`{% web_view %}`	Bekijken in je browser
Zie je deze e-mail niet? `{% web_view 'Open in your browser' %}`.	Zie je deze e-mail niet? Openen in je browser.
`Dit is een speciale <a href="{% web_view_link %}" >link voor webweergave</a>.`	Dit is een speciale link voor webweergave.

Voorbeeldweergave van de tekst

In sommige gevallen wil je misschien je voorbeeldtekst weergeven in de tekst van je template. Je kunt naar elke voorbeeldtekst verwijzen die je hebt ingesteld in het voorbeeld-/instelscherm van de e-mail door de tag {% render_variable preview_text %} te gebruiken.

Als je de voorbeeldtekst op het e-mailvoorbeeldscherm bijwerkt, geeft deze tag je bijgewerkte voorbeeldtekst weer.

Aangepaste template- en gebeurtenistags

Aangepaste tags verwijzen naar aangepaste profieleigenschappen (d.w.z. gegevens die je verzamelt over je contactpersonen anders dan speciale Klaviyo-eigenschappen en -gebeurtenissen), zoals iemands verjaardag of contactvoorkeuren. Gebeurtenistags verwijzen naar de gegevens van een specifieke gebeurtenis (bijv. een gebeurtenis van een geplaatste bestelling) en kunnen alleen worden gebruikt in flows die door die gebeurtenis worden getriggerd.

Om een aangepaste tag toe te voegen, klik je op Personalisatie in een e-mailtekstveld en zoek je de tag. Om een gebeurtenistag toe te voegen, bekijk je een voorbeeld van je bericht en kopieer je de gebeurtenisvariabele-tag uit de voorbeeldgegevens. Je kunt ook de onderstaande indelingen gebruiken om handmatig een aangepaste tag aan je template toe te voegen.

Tagindeling	Beschrijving	Voorbeeld
`{{ person.property_name }}`	Een eenvoudige profielpersonalisatietag	`{{ person.Birthday }}`
`{{ person\|lookup:'property name' }}`	Een profielpersonalisatietag, als de naam van de eigenschap spaties of speciale tekens bevat	`{{ person\|lookup:'Favorite Color' }}`
`{{ event.property_name }}`	Een eenvoudige tag voor gebeurtenisvariabelen	`{{ event.URL }}`
`{{ event\|lookup:'property name' }}`	Een tag voor een gebeurtenisvariabele, als de naam van de variabele spaties of speciale tekens bevat	`{{ event\|lookup:'$value' }}`
`{{ event.property.nested_variable }}`	Een tag voor een gebeurtenisvariabele, als de gebeurtenisvariabele genest is in de gebeurtenisgegevens	`{{ event.extra.checkout_url }}`
`{{ event\|lookup:'property name'\|lookup:'nested variable name' }}`	Een tag voor een gebeurtenisvariabele, als de gebeurtenisvariabele genest is in een andere variabele met een naam die een spatie of speciaal teken bevat	`{{ event\|lookup:'Coupon Codes'\|lookup:'0' }}`

Gebruik de punt-notatie (.) voor tags zonder spaties of speciale tekens. Als de namen van je eigenschappen spaties of speciale tekens (bijv. $) bevatten, gebruik dan de Lookup-notatie.

Voor geneste eigenschappen geldt dat als je voor één eigenschapsnaam de Lookup-notatie gebruikt, je ook voor alle latere eigenschappen de Lookup-notatie moet gebruiken. Dit betekent dat event|lookup:'Collection Names'|lookup:'0' juist is, maar event|lookup:'Collection Names'.0 niet.

Tags aanpassen met filters

Om de manier aan te passen waarop je tags worden weergegeven, pas je templatefilters toe. Je kunt filters gebruiken om hoofdletters toe te passen, het aantal decimalen voor een getal in te stellen en nog veel meer. Twee van de meest voorkomende filters zijn standaard en titel.

Het filter standaard stelt een standaardwaarde in die verschijnt als de ontvanger van een bericht die eigenschap niet heeft ingesteld. In het onderstaande voorbeeld zijn 'friend' en 'tasty treats' ingesteld als de standaardwaarden voor het geval dat de naam of het favoriete voedsel van een ontvanger niet is ingesteld in hun Klaviyo-profiel.

Tekst met personalisatietags	Uitvoer
Hey `{{ first_name\|default:'friend' }}`, any interest in some `{{ person\|lookup:'Favorite Food'\|default:'tasty treats' }}`?	Hey friend, any interest in some tasty treats?

Met het filter titel kun je hoofdlettergebruik toepassen op elke teksttag, zodat deze consistent wordt weergegeven nadat het bericht is verzonden. Sommige abonnees gebruiken bijvoorbeeld allemaal hoofdletters of allemaal kleine letters wanneer ze je aanmeldingsformulier invullen. Zonder een filter wordt hetzelfde hoofdlettergebruik voor hun voornaam toegepast dat ze gebruikten toen ze je formulier invulden. De titel-filter corrigeert echter het hoofdlettergebruik zodat hun naam correct verschijnt.

Tekst met personalisatietags	Uitvoer
Hey `{{ first_name\|title }}`, have you seen our latest launch?	Hey Elise, have you seen our latest launch?

Er zijn tientallen andere filters beschikbaar voor je berichten. Meer informatie over het gebruik van filters om tags aan te passen.

Datumtags

Met datumtags kun je snel datuminformatie invoegen in een e-mail. De datum staat in de tijdzone van je account en geeft de dag of tijd aan waarop een bericht is verzonden.

De tag {{ today }} is een van de meest gebruikte datumlabels en vult een tijdstempel in wanneer het bericht wordt verzonden. Om deze tag te gebruiken, plak je de volgende regel code in je template:

{% today "%Y-%m-%d" as today %} {{ today }}

Merk op dat het gebruik van de tag {{ today }} zonder de voorafgaande code niets weergeeft. De volledige regel code is nodig.

Voor meer informatie over hoe je datumtags gebruikt of aanpast, ga je naar ons artikel over datumtags in templates.

Valutatags

Gebeurtenisgegevens zoals onder andere Bestelling Geplaatst en Toegevoegd aan Winkelwagen zijn vaak gekoppeld aan een financiële waarde (bijv. de prijs van een product of de waarde van de winkelwagen van een klant). Gebruik de tag {% currency_format … %} om de valutanotatie van je land toe te passen op die waarde.

Bekijk bijvoorbeeld het veld $value in de meetwaarde Afrekenen Gestart hieronder:

Door alleen de variabele {{ event|lookup:"$value" }} te gebruiken, wordt deze eigenschap weergegeven met slechts één decimaal en zonder valutasymbool in de e-mail:

Maar met de tag Valutanotatie {% currency_format event|lookup:"$value" %} wordt het getal weergegeven met een valutasymbool en het juiste aantal decimalen:

Als je de tag voor valutanotatie wilt gebruiken, vervang je de tekst in {% currency_format PLACEHOLDER %} met je variabele.

Als je variabele bijvoorbeeld {{ event.item.price }} is, wordt de volledige tag voor valutanotatie:{% currency_format event.item.price %}. Als je tag filters bevat (bijvoorbeeld een standaardwaarde voor het geval de eigenschap leeg is), neem die dan ook op in de tag: {% currency_format event.item.price|default:”0” %}.

Een land selecteren

Er zijn 2 plaatsen waar je de valutanotatie voor je berichten kunt instellen:

Voor je hele account
Ga naar Instellingen > Organisatie > Organisatietaal en regionale opmaak en selecteer Organisatietaal.
Voor een specifiek bericht
Selecteer een andere valutanotatie voor een afzonderlijk bericht in de template van het bericht op het tabblad Stijlen in het gedeelte Valuta.

Problemen oplossen met de tag currency_format

Deze tag wordt alleen ondersteund voor variabelen die getallen zijn (bijvoorbeeld 10, 24,56). Eigenschappen waarbij het valutasymbool inbegrepen is (bijvoorbeeld $ 40, $ 76,30) zijn tekenreeksen en de tag currency_format kan deze niet wijzigen.

Voorwaardelijke instructies

Met voorwaardelijke tags kun je content in je berichten opnemen voor ontvangers die aan bepaalde criteria voldoen, en deze niet opnemen voor andere ontvangers. Ze geven je krachtige mogelijkheden om je bericht voor elke ontvanger te personaliseren.

If-instructies

Met If-instructies kun je bepalen welke content iemand ontvangt op basis van profiel- of gebeurtenisgegevens.

In het onderstaande voorbeeld krijgen ontvangers de eerste regel tekst te zien als ze meer dan 150 spaarpunten hebben. Als ze minder dan 150, maar meer dan 0 punten hebben, zien ze de tweede regel. En als ze geen loyaliteitspunten hebben, zien ze het derde bericht.

{% if person|lookup:'Loyalty Points' > 150 %}
Hallo vip! Je krijgt altijd gratis verzending en gratis retourneren
{% elif person|lookup:'Loyalty Points' > 0 %}
Je hebt {{ person|lookup:'Loyalty Points' }} punten en je hebt er nog maar 150 nodig om vip te worden! 
{% else %}
Heb je al gehoord van ons vipprogramma? Meld je vandaag aan via onze website en begin met het verzamelen van beloningen.
{% endif %}

Binnen een if-instructie is een initiële {% if … %} voorwaarde nodig, evenals een afsluitende {% endif %}-tag. Alle andere elementen (d.w.z. {% elif %}- en {% else %}-tags) zijn optioneel. Je kunt een onbeperkt aantal {% elif %}-tags gebruiken, gevolgd door maximaal één {% else %}-tag. Ontvangers van een e-mail krijgen alleen het eerste bericht te zien waarvoor ze in aanmerking komen.

For-instructies

Met for-blokken kun je elk item in een variabele herhalen die een lijst opslaat en deze afzonderlijk renderen. Hieronder staat een voorbeeldinstructie:

{% for item in event.shopping_cart_items %}{{ item.name }} × {{ item.quantity }} {% endfor %}

Extra grote stranddoek × 1

Strandstoelen × 4

SPF zonnebrandcrème × 2

Plastic koelbox × 1

Elke for-instructie moet het volgende bevatten:

Een openingstag {% for … %} met een rijalias (item in het bovenstaande voorbeeld) en rijverzameling (event.shopping_cart_items in het bovenstaande voorbeeld)
Een afsluitende {% endfor %}-tag

Tussen de twee verplichte tags kun je elke tekst invoegen die je maar wilt. Om variabelen op te nemen die genest zijn binnen de rijverzameling, vervang je het begin van de variabelenaam (de rijverzameling plus het nummer dat volgt op de rijverzameling) door je rijalias. De variabele {{ event.shopping_cart_items.0.name }} wordt dan {{ item.name }}.

Voorwaardelijke instructies en de inline teksteditor

Wanneer je bepaalde voorwaardelijke instructies toevoegt aan een tekstblok, kunnen deze verdwijnen uit de inline teksteditor. De code is nog steeds aanwezig, maar deze is verborgen. Om voorwaardelijke instructies te bekijken en te bewerken, open je het veld Broncode van het tekstblok.

De volgende tags zijn alleen zichtbaar in het veld Broncode van een tekstblok:

{% for ... %}
{% endfor %}
{% if ... %}
{% elif ... %}
{% else %}
{% endif %}
{% with ... %}
{% endwith %}

Extra hulpbronnen

Was dit artikel nuttig?

Gebruik dit formulier alleen voor feedback op artikelen. Meer informatie over hoe je contact opneemt met support.

Ontdek meer van Klaviyo

Community

Maak contact met collega's, partners en Klaviyo-experts om inspiratie op te doen, inzichten te delen en antwoorden te krijgen op al je vragen.

Naar de community

Live training

Neem deel aan een live sessie met Klaviyo-experts voor meer informatie over best practices, het instellen van belangrijke functies en andere onderwerpen.

Nu aanmelden

Support

Krijg ondersteuning via je account.

E-mailsupport (gratis proefperiodes en betaalde accounts) 24/7 beschikbaar

Chat-/virtuele assistentie
Beschikbaarheid varieert per locatie en type abonnement

Inloggen