Using merge fields in messages
When sending email, SMS or push messages via the Message Centre or Scheduled Broadcasts, there are a number of merge fields that you can use within your messages.
What is a merge field?
A merge field is a placeholder element that is replaced by contextually relevant content when a message is sent. For example, this could be [[MEMBER.FIRSTNAME]], which is then replaced with the member’s first name when the message is sent to them.
There are four sets of fields relevant to generic messages sent from GymOS, plus a vast number of additional fields that become relevant when used in Triggers, Nurture Programs, or other areas of the system that send messages.
- BUSINESS
The business fields provide fill-in data relating to your business. - CURRENTUSER
You (the sender) are the “current user”. The current user fields are the same as the member fields, but contain the data relating to the sender as opposed to the recipient. - MEMBER
If you are sending a message to a member, the “member” merge fields are available and contain data relating to the recipient. - LEAD
If you are sending a message to a lead, the “lead” merge fields are available and contain data relating to the recipient.
Note: If you are sending a message to both members and leads, use the member name fields. The lead’s name will also be populated into the [[MEMBER.FIRSTNAME]] and [[MEMBER.LASTNAME]] fields.
The pre-defined merge fields for the four aforementioned types are listed below.
| FIELD TYPE | AVAILABLE FIELDS |
|---|---|
| Business | [[BUSINESS.ADDRESS1]] – Address line 1[[BUSINESS.ADDRESS2]] – Address line 2[[BUSINESS.ADDRESSLINE]] – Full address in single line format[[BUSINESS.ADDRESSPARA]] – Full address in paragraph format[[BUSINESS.BUSINESSNAME]] – The business name[[BUSINESS.BUSINESSPHONE]] – The business phone[[BUSINESS.CITY]] – Address city[[BUSINESS.COMPANYNUMBER]] – The business registered company number[[BUSINESS.CONTACTEMAIL]] – The primary contact email[[BUSINESS.COUNTRY]] – The business country[[BUSINESS.FITNESSHUBURL]] – The business FitnessHub URL[[BUSINESS.GDPREMAIL]] – The GDPR email address for the company[[BUSINESS.POSTCODE]] – Address postcode[[BUSINESS.QUOOXEMAILADDRESS]] – Quoox email address[[BUSINESS.SHORTCODE]] – Business shortcode[[BUSINESS.SHORTNAME]] – Business shortname[[BUSINESS.STATE]] – Address state[[BUSINESS.TRADINGNAME]] – Trading name[[BUSINESS.TWILIONUMBER]] – SMS/Text number[[BUSINESS.VATNUMBER]] – VAT/Tax number[[BUSINESS.VCARDURL]] – Contact Card URL[[BUSINESS.WEBSITEURL]] – Website URL |
| Current User | [[CURRENTUSER.COMMSEMAIL]] – Main communication email[[CURRENTUSER.COMMSMOBILE]] – Main communication mobile[[CURRENTUSER.EMAIL]] – Email address[[CURRENTUSER.FIRSTINITIAL]] – First letter of first name[[CURRENTUSER.FIRSTNAME]] – First name[[CURRENTUSER.INITIALS]] – First and last initial[[CURRENTUSER.KNOWNASNAME]] – Known as name/nickname[[CURRENTUSER.LASTINITIAL]] – First letter of last name[[CURRENTUSER.LASTNAME]] – Last name[[CURRENTUSER.MIDDLENAMES]] – Middle name(s)[[CURRENTUSER.MOBILE]] – Mobile number |
| Member | [[MEMBER.ADDRESSLINE]] – Full address in line format[[MEMBER.ADDRESSPARA]] – Full address in paragraph format[[MEMBER.BLOCKEDUNTIL]] – Date a member is blocked until[[MEMBER.COMMSEMAIL]] – Main communication email[[MEMBER.COMMSMOBILE]] – Main communication mobile[[MEMBER.CURRENTTOTALCREDITS]] – Current available credits[[MEMBER.EMAIL]] – Email address[[MEMBER.EMERGENCYADDRESS]] – Emergency address[[MEMBER.EMERGENCYCONTACT]] – Emergency contact[[MEMBER.EMERGENCYPHONE]] – Emergency telephone[[MEMBER.EMERGENCYRELATIONSHIP]] – Emergency relationship[[MEMBER.FIRSTINITIAL]] – First letter of first name[[MEMBER.FIRSTNAME]] – First name[[MEMBER.FUNDINGMEMBERNAME]] – Name of the funding member[[MEMBER.HOMEADDRESS1]] – Address line 1[[MEMBER.HOMEADDRESS2]] – Address line 2[[MEMBER.HOMEADDRESS3]] – Address line 3[[MEMBER.HOMECITY]] – Address city[[MEMBER.HOMECOUNTY]] – Address county/state[[MEMBER.HOMEPOSTCODE]] – Address postcode/zipcode[[MEMBER.INITIALS]] – First and last initial[[MEMBER.KNOWNASNAME]] – Known as name/nickname[[MEMBER.LASTINITIAL]] – First letter of last name[[MEMBER.LASTNAME]] – Last name[[MEMBER.MIDDLENAMES]] – Middle name(s)[[MEMBER.MOBILE]] – Mobile number[[MEMBER.PREVIOUSNAMES]] – Previous name(s)[[MEMBER.SESSIONWEBCALURL]] – Session calendar URL |
| Lead | [[LEAD.EMAIL]] – The email address of the lead[[LEAD.FIRSTNAME]] – The first name of the lead[[LEAD.LASTNAME]] – The last name of the lead[[LEAD.LOGINURL]] – The FitnessHub login URL for the lead[[LEAD.MOBILE]] – The mobile number for the lead[[LEAD.SHORTCODE]] – shortcode |
Common merge fields are typically provided in a drop-down selection list when creating a message. The more advanced merge fields are added by cutting-and-pasting or typing them manually into your message.
Note: Clicking on any of the merge fields in this help document will add it to your clipboard for easy pasting into your message.
Don’t be that person…
Make sure you don’t mix up the [[CURRENTUSER]] and [[MEMBER]] merge tags! You don’t want to be the person who sends out a “personalised message” that starts Dear John and ends From John. It isn’t a good look, and whilst everyone knows merge fields are used in messaging, it gives the appearance of not caring.