Personalize (variables)
In order to create a personalized experience for your customer or recipient, we have created a system to personalize each sent postcards, without editing your design for each order.
Merge variables
Personalizing a postcard is done using 'merge variables'. An example of a merge variable is 'first name'. In your design, you use double curly brackets for this, so {{firstName}} or {{name}} or some variant.
An example of the usage of merge variables can be seen in the image below. Different merge variables are used there. For example: {{name}}, {{discount}} and {{discountcode}}. Anytime you send a postcard, our system will ask you which values you want to populate these merge variables with. For {{name}} you could for example enter 'Jane'.
If you want to insert HTML in a merge variable, use triple curly brackets. For example: {{{HTML}}}
For all other merge variables, use double curly brackets. For example: {{text}} {{url}} {{image-url}} etc.
Merge variable names best practices
Use clear and concise names for your merge variables;
Do not use dots or spaces;
Merge variables can contain the following characters:
abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ-_We do not recommend using numbers in the names, as most integrations in other platforms do not like this.
The value of a merge variable can be anything you like.
For more information about using the API and the JSON structure of your API calls with merge variables, see the API section.
Insert HTML into merge variables
It is possible to insert HTML into a merge variable. This opens up many possibilities in styling text differently on each item you send.
If you want to insert HTML into a merge variable, use triple curly brackets instead of double brackets: {{{...}}}
Example: on the back side of the card you are using a merge variable {{{message}}}. Now you can fill this merge variable with a value like <span style="color:blue">John Doe</span>. The result will be a piece of blue text.
Variable images
Even images can be personalized per sent postcard. You can add variable images using the "Add variable image per recipient" button in the editor.
You will be asked to enter a name for the merge variable. In the example below, we use "imageUrl". A placeholder image will appear, which you can resize to your desired dimensions. You could for example change the image based on the gender of a baby that was born.
The value of the merge variable must be an external image. It is important that the server can return the images properly and that an HTTP code of 2xx is returned. If an image is not loaded because no 2xx HTTP code is returned, the order will fail.
QR Codes
It is also possible to personalize QR codes. Read more about personalizing QR codes on the QR codes page.