Skip to main content
All CollectionsTips & tricks
Include variables in your emails and Saved Replies
Include variables in your emails and Saved Replies

Use special keywords in your emails that will be replaced by the relevant value when the email is sent.

Mark Fowles avatar
Written by Mark Fowles
Updated over 10 months ago

Variables are special keywords that you can use in your emails or saved replies. Variables will be replaced by their relevant value when an email is sent.
​
For example - If you you the variable {%recipientFirstname%} in an email, when the email is sent, the variable will be replaced with the first name of the first recipient in the "To" field of your email.

Variables are only available on certain SendBoard plans. See plans and pricing here.

Here is a complete list of all the SendBoard variables

#️⃣ General Variables

Variable

Description

Example

{%mailboxName%}

The name of the Mailbox

ACME support team

{%referenceNumber%}

The reference number of the email conversation

REF936


πŸ‘€ Email Contact Variables

The "Recipient" is the first email recipient in the "To" field of outgoing emails.

Variable

Description

Example

{%recipientFirstname%}

First Name

John

{%recipientLastname%}

Last Name

Lennon

{%recipientFullname%}

Full Name

John Lennon

The "Contact" is the contact associated with the Trello card (shown on the card back).

Variable

Description

Example

{%contactFirstname%}

First Name

Paul

{%contactLastname%}

Last Name

McCartney

{%contactFullname%}

Full Name

Paul McCartney

The "Trello User" is the Trello team member who is sending the email

Variable

Description

Example

{%userFirstname%}

First Name

George

{%userLastname%}

Last Name

Harrison

{%userFullname%}

Full Name

George Harrison

In case the contact or recipient doesn’t have a name set, you can use the following trick to specify alternative text to use as a fallback.

{%variable || 'fallback'%}

e.g. Hi {%contactFirstname || 'there'%}, thanks for your email.

If you use the above example in an email, when the email is sent and there is no first name for the contact, the text β€œHi there, thanks for your email.” will be inserted.


πŸ“… Date/Time Variables

Variable

Description

Example

{%date.now%}

The current date

October 3, 2016

{%date.weekday%}

The current weekday

Monday

{%date.dayOfWeek%}

The current day of the week as a number

01 (for Monday)

{%date.weeknumber%}

ISO week numbering (starts on Monday)

40

{%date.month%}

The current month

October

{%date.monthshort%}

The short name of the current month

Oct

{%date.monthOfYear%}

The current month of the year

01 (for January)

{%date.year%}

The current year

2021

{%date.dayofmonth%}

The current day of the month

09

{%date.time%}

The current time

11:23 AM

These variables can be combine to construct custom date formats.

{%date.monthOfYear%}-{%date.dayofmonth%}-{%date.year%} {%date.time%} 

This would result in e.g. 01-25-2021 11:23 AM


πŸ’» Board and Card Variables

Variable

Description

Example

{%board.name%}

The name of the board

Project Phoenix

{%board.description%}

The description of the board

This board is where the magic happens.

{%board.link%}

A link to the open the current board

http://trello/b/eg908...

{%card.name%}

The name of the card

New Request

{%card.description%}

The card's description (not always available)

This card is about...

{%card.link%}

A link to the current card

http://trello/c/eg908...

{%card.number%}

The internal number of the card on the board. This value changes when the card is moved to another board (not always available).

48

{%card.id%}

The internal ID of the card (always constant).

FY2OWrnc

{%card.idLong%}

The internal long ID of the card (always constant).

571d07b591c8b68aeb4f6acc

{%card.listname%}

The list that the card is currently in

To-Do

{%card.labelnames%}

The names of all the named labels in the card, comma separated

Urgent, Important

{%card.duedate%}

The due date of the card (not always available)

Jan 16, 2021 02:55 PM

{%card.creationdate%}

The date the card was created

Jan 11, 2021 11:20 AM

{%card.age%}

The age of the card in human friendly text

a few days ago

{%card.ageindays%}

The age of a card in days, with two decimals

1.25 (for 1 day 6 h)

{%card.ageinhours%}

The age of a card in hours, with two decimals

1.67 (for 1 hour 40mins)


πŸ‘©β€πŸ’» Card Member Variables

Variable

Description

Example

{%card.memberfullnames%}

The full names of all the members of the card, comma separated

John Lennon, Paul McCartney, George Harrison and Ringo Starr

{%card.firstmemberfullname%}

The full name of the first member listed on the card

John Lennon

{%card.firstmemberusername%}

The Trello user name of the first member listed on the card

johnlennon

{%card.firstmemberinitials%}

The initials of the first member listed on the card

JL


βœ… Card Checklist Variables

Variable

Description

Example

{%card.checklistcount%}

The number of checklists on the card

1

{%card.completechecklistcount%}

The number of complete checklists on the card

0

{%card.incompletechecklistcount%}

The number of incomplete checklists on the card

1

{%card.checkliststate%}

A formatted text with the state of all the checklists in the card, useful to add a comment with a snapshot of the state of a card's checklists.

Shopping List

β˜‘οΈŽ Bread

☐ Milk
☐ Cheese
​
​To do
β˜‘οΈŽ Pick up the mail
☐ Fill up with gas
​
​


πŸ”€ Custom Field Variables

You can also use variables to insert the value of Trello Custom Fields into your emails. Just use the Custom Field name (spaces replaced with underscore "_"), and SendBoard will replace the variable with the value of the custom field. Make sure to wrap the variable name in {% %} characters, just like other variables.

For example, if you have a custom field called 'Order Number', you can insert this value into an email by using the variable name {%Order_Number%} .

Make sure that you use the correct case for your Custom Field names. i.e. If there are capital letters in the Custom Field, the variable should have the same.


❓ Variable Fallbacks

In case any of the above variables have no value set, you can use the following trick to specify alternative text to use as a fallback.

{%variable || 'fallback'%}

e.g. The due date is {%card.duedate || 'not yet set'%}

If you use the above example in an email, when the email is sent and there is no due date set on the card, the text β€œThe due date is not yet set.” will be inserted.

Did this answer your question?