Skip to main content
Browse documentation

Type to search the documentation. Press Esc to close.

How do merge fields work in a Scribble message?

Put a field name in double braces and it is replaced per recipient: {{first_name}}, {{full_name}}, {{company}}, {{job_title}}, {{city}}, {{state}} and {{sender_name}} are always available, plus any extra column from your upload, named after the header in snake_case.

On this page

#Built-in fields

Built-in merge fields
FieldValue
{{first_name}}The contact's first name.
{{last_name}}The contact's last name.
{{full_name}}First and last together, or the full name column if you imported one.
{{company}}The company on the contact.
{{job_title}}The job title on the contact.
{{city}}The contact's city.
{{state}}The contact's two-letter state code.
{{sender_name}}The sender value set for this send, rule or hook. Use Sign-off for a separate closing line on the card.
{{years}}Work anniversary rules only. The number of years since the start date. Not substituted when the count is zero.

#Custom columns

A column called Personal note becomes personal_note, available as {{personal_note}}. Use the field picker in the message composer to insert the correct token.

#Missing or mistyped fields

If a required value is missing, the recipient is blocked or skipped. Fill in the contact field, use a fallback where the composer offers one, or remove the token. The checks run across every recipient before a mailing is scheduled.

Use lowercase names with underscores inside double braces: {{first_name}}. The composer flags near misses such as {first_name} or {{First Name}}. Fix them before sending.

#Check the complete card

  • Check the longest name and company values in the merged previews.
  • Add the Sign-off as a separate closing line. Do not repeat it inside the message unless you intend to write it twice.
  • Keep the full merged message within the 500-character limit and check that it fits.
  • In API JSON, use ` ` for a paragraph break.
Example message
Happy birthday, {{first_name}}!

We’re glad you’re on the team. Have a great day.

{{sender_name}}

Last checked against the product on . Something wrong or missing? Tell us.