Docs

Personalization

Put each person's name and details on the card, and change images per person.

Who can use this: Any plan. Any role. Needs: A template, and recipients with the values that the fields print.

Overview

Personalization prints different values on each card of one campaign. A merge field prints a value of each recipient, such as the first name. A variable image prints a different image for each recipient.

You can use Personalization to:

  • Greet each recipient by name in the handwritten message.
  • Print the city, the street or one of your own custom values.
  • Set a fallback value, so a card never has a blank space.
  • Change an image on the card for each recipient.

Pages in this section

Merge fields and fallback values

A merge field is a token in braces, such as {{FIRST NAME}}. When LettrLabs prints the card, it puts the value of each recipient in place of the token. When a recipient has no value, LettrLabs prints the fallback value.

The Mail-Merge Fields section of the Personalize panel has two lists:

ListFields
Named FieldsFirst Name, Last Name, Organization, Address 1, Address 2, Street Name, City, State, Zip, Salutation, Radius Pin Address, Radius Pin Street, To Organization, Discount Code, Zip Code, Country
Custom FieldsCustom 1 to Custom 6

The custom fields print the values of your own columns, such as a job type or a technician name. Discount Code prints a coupon code. QR codes and offers explains it.

Personalize a card with merge fields

Do this on the Design step of a template, after you write the message.

On the card, click in the text where the value goes. For example, click after "Dear ".

In the dock at the left of the editor, click Personalize.

Under Mail-Merge Fields, open Named Fields or Custom Fields, and select a field. The token, such as {{FIRST NAME}}, shows in the text.

Under the list, find the line of the field. Enter a Fallback Value, such as Neighbor.

Do steps 1 to 4 again for each field that you need.

A field that is already in the text shows "(In use)" in the list. Do not type a token by hand. Use the list, so LettrLabs can read the token.

The Personalization card of the Design step shows each merge field with its fallback value. A field with no fallback value shows "No Fallback Value". Click Add Fallback Value under the field. The Personalize panel opens at the input of that field.

You're done when each token shows in the text, and each field has a fallback value.

Preview the card with merge fields

Do this before you approve the proof. Long values can push text out of its box.

In the Personalize panel, click Preview template with merge fields. The Preview Mail-Merge Template dialog opens.

Read each side of the card. LettrLabs fills each field with a very long sample value, to show the worst case.

Under Highlight Options, turn on Mail-Merge Fields, Mail-Merge Images, Overflow Boxes or Bleed & Safe Zone.

When a side shows Overflow Detected, close the dialog. Make the text box larger, or make the font smaller.

You're done when no side shows Overflow Detected. A real value is usually shorter than the sample. You can still continue with an overflow warning.

Add a variable image

Do this when each recipient needs a different picture, such as a photo of their own home. A card can have six variable images at most.

On the Design step, click Personalize in the dock.

Under Mail-Merge Image, click Add Image. A placeholder shows on the card. In the panel, a card named IMAGE 1 shows.

Move the placeholder to its place, and set its size. You can also enter the size under Resizing.

Click the placeholder thumbnail in the panel, and upload a fallback image. The Fallback Image prints when a recipient has no image.

The counter beside Mail-Merge Image shows how many of the six you use. Each image card also shows the side of the card: Card Front or Card Back. To copy an image, click Duplicate. To delete it, click Remove.

You give the image of each recipient with your recipients. In an order, the recipient form has a Variable Images panel with one slot for each image. Use an image with the same aspect ratio as the placeholder. An empty slot prints the fallback image.

You're done when each placeholder has a fallback image. Not every way of sending accepts a template with variable images. The FAQ lists the message that shows.

FAQ

Steps checked 2026-11-16.

On this page