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.

e.g. If you type the text {% 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.

These are the variables you can use in your emails.


{% mailboxName%}
{% referenceNumber%}

Email Recipient - The first email recipient in the "To" field

{% recipientFirstname%}
{% recipientLastname%}
{% recipientFullname%}

Card Contact - The contact associated with the Trello card

{% contactFirstname%}
{% contactLastname%}
{% contactFullname%}

Trello user - The team member sending the email

{% userFirstname%}
{% userLastname%}
{% userFullname%}

In case the contact 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.

Custom Fields

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.

Use Trello Variables in Butler Rules

The above variables can be used in your Saved Replies and other SendBoard templates. But if you're using Butler to send out automated emails using our @email/@reply feature, there are a ton of other variables you can use.

Since Butler is a built-in feature of Trello, Butler can insert values from many different areas of Trello. Here are some examples.

  • {date} e.g. October 3, 2016

  • {weeknumber} e.g. 40 (ISO week numbering -- starts on Monday)

  • {boardname} the name of the board

  • {cardname} the card's name

  • {carddescription} the card's description (not always available)

  • {cardlink} a link to the current card

  • {cardlistname} the name of the list where the card is (not always available)

  • {cardlabelnames} the names of all the named labels in the card, comma separated

  • {cardmemberfullnames} the full names of all the members of the card, comma separated

  • {cardfirstmemberusername}, {cardfirstmemberfullname}, {cardfirstmemberinitials} the details of the first member in the card.

  • {cardcheckliststate} 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.

  • {cardchecklistcount} the number of checklists on the card.

  • {cardcompletechecklistcount} the number of complete checklists on the card.

  • {cardincompletechecklistcount} the number of incomplete checklists on the card.

  • {cardduedate} the due date of the card (not always available).

  • {cardcreationdate} the date the card was created.

  • {cardagedays} the age of a card in days, with two decimals (e.g. 1d 6h => 1.25).

  • {cardagehours} the age of a card in hours, with two decimals (e.g. 1h 40m => 1.67).

These are just a few examples of Trello variables you can use in Butler rules. Find the full list of variables here.

It's important to understand that these variables can't be used within a SendBoard Saved Reply, since Butler does not have access to replace variables within SendBoard templates. But these variables can be used in Butler actions, and can be combined with SendBoard Saved Replies and variables.

e.g. You could use Butler to automatically post the following comment when a card is moved to the "In-Progress" list.

  • {cardfirstmemberfullname}, {cardlistname}, {cardcreationdate},{cardduedate} and {cardfirstmemberfullname} are Trello variables that will be replaced by Butler.

  • {% recipientFirstname || "there"%} and {% referenceNumber%} are SendBoard variables.

  • ##status will insert the Saved Reply with the keyword status

The recipient will receive an email update with all of the variables replaced with their corresponding values.

Did this answer your question?