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
| Field | Value |
|---|---|
{{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.
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.
