Use participant references to personalize messages to your participants. Greet them by name, remind them of their table, or send them a link to add a credit card.
Examples below use a sample participant named Jane Smith, who is linked to Tom Smith.
Which form should I use?
Which form works depends on where you use the reference:
- Emails built in the email editor: full form only, such as
{{ Bidder.FirstName }}. - Basic emails, PDF receipt headers and footers, statement email headers and footers, and Word document templates: short form only, such as
{{ FirstName }}. - Text messages: either form.
See Where you can use references for the full list. Participant. works the same as Bidder., so {{ Participant.FirstName }} also works wherever the full form does.
Names
| What it shows | Short form | Full form | Example |
|---|---|---|---|
| First name | {{ FirstName }} | {{ Bidder.FirstName }} | Jane |
| Last name | {{ LastName }} | {{ Bidder.LastName }} | Smith |
| Full name | {{ Name }} | {{ Bidder.Name }} | Jane Smith |
| Names of the participant and their linked participants | {{ GreetingNames }} | {{ Bidder.GreetingNames }} | Jane & Tom Smith |
| First names of the participant and their linked participants | {{ FirstNames }} | {{ Bidder.FirstNames }} | |
| Additional participants, exactly as typed on the participant's record | {{ AdditionalBidders }} | {{ Bidder.AdditionalBidders }} | Tom Smith |
{{ GreetingNames }} adjusts to the participant:
| Participant | {{ GreetingNames }} shows |
|---|---|
| Linked to someone with the same last name | Jane & Tom Smith |
| Linked to someone with a different last name | Jane Smith & Tom Jones |
| Not linked to anyone | Jane Smith |
Greeting couples and households:
{{ GreetingNames }} makes a warm greeting for couples and households, and still works for participants on their own: "Dear Jane & Tom Smith" or "Dear Jane Smith".
Contact details
| What it shows | Short form | Full form | Example |
|---|---|---|---|
| Company | {{ Company }} | {{ Bidder.Company }} | Smith Consulting |
| Phone number | {{ Phone }} | {{ Bidder.Phone }} | (555) 123-4567 |
| Cell phone number | {{ MobilePhone }} | {{ Bidder.MobilePhone }} | (555) 987-6543 |
| Email address | {{ Email }} | {{ Bidder.Email }} | jane@example.com |
Address
| What it shows | Short form | Full form | Example |
|---|---|---|---|
| Address line 1 | {{ Address1 }} | {{ Bidder.Address1 }} | 123 Main Street |
| Address line 2 | {{ Address2 }} | {{ Bidder.Address2 }} | Suite 4 |
| City | {{ City }} | {{ Bidder.City }} | Springfield |
| State | {{ State }} | {{ Bidder.State }} | IL |
| Zip code | {{ Zip }} | {{ Bidder.Zip }} | 62701 |
| Country | {{ Country }} | {{ Bidder.Country }} | United States |
Event details
| What it shows | Short form | Full form | Example |
|---|---|---|---|
| Paddle# | {{ Number }} | {{ Bidder.Number }} | 112 |
| Participant access code | {{ AccessCode }} | {{ Bidder.AccessCode }} | X7K2P9 |
| Table number | {{ Table }} | {{ Bidder.Table }} | 8 |
| Table description | {{ Table_Description }} | {{ Bidder.Table_Description }} | Sponsor Table |
| Meal choice | {{ MealChoice }} | {{ Bidder.MealChoice }} | Vegetarian |
| Notes | {{ Notes }} | {{ Bidder.Notes }} | Arriving late |
Internal notes:
Notes are often used for internal comments. Check what your team has entered before including {{ Notes }} in a message to participants.
Links
| What it shows | Short form | Full form |
|---|---|---|
| Link to add a credit card | {{ RegisterCreditCardUrl }} | {{ Bidder.RegisterCreditCardUrl }} |
| Shortened link to add a credit card | {{ ShortRegisterCreditCardUrl }} | {{ Bidder.ShortRegisterCreditCardUrl }} |
Links in text messages:
Use the shortened link in text messages. It takes up less space and is easier to tap.
Receipt totals
These totals are only available in PDF participant receipt headers and footers. They don't work in statement emails, text messages, or the email editor. Use the short form.
| What it shows | Code | Example |
|---|---|---|
| Balance due | {{ Balance }} | $250.00 |
| Total of items won | {{ WonBidsTotal }} | $650.00 |
| Total of bids currently winning, where bidding is still open | {{ WinningInProgressBidsTotal }} | $100.00 |
| Total of purchases | {{ PurchasesTotal }} | $75.00 |
| Total of donations | {{ DonationsTotal }} | $200.00 |
| Total of tickets purchased | {{ TicketsPurchasedTotal }} | $150.00 |
| Total charges | {{ DebitTotal }} | $1,075.00 |
| Tax-deductible amount | {{ TaxDeductibleAmount }} | $350.00 |
| Whether the participant has any activity | {{ HasActivity }} |
Totals in receipt footers:
Totals are a good fit for a receipt footer, for example: "Thank you for your support! Your items won total {{ WonBidsTotal }}."
{{ Balance }} and {{ TaxDeductibleAmount }} also appear in some system emails, such as purchase and registration receipts. See What's included in system emails.
Word document templates only
These references only work in Word document templates. Elsewhere, they show up blank.
Lists
Loop through these lists with {% foreach ListName %} … {% end %}. See Lists and Word document templates.
| What it shows | Code |
|---|---|
| Items won | ItemsWon |
| Purchases | Purchases |
| Donations | Donations |
| Payments | Payments |
Each entry in Payments is a payment. Use Payment References inside the loop.
Totals and counts
| What it shows | Code |
|---|---|
| Total of items won | {{ ItemsWon_Total }} |
| Total of purchases | {{ Purchases_Total }} |
| Total of donations | {{ Donations_Total }} |
| Total of payments | {{ Payments_Total }} |
| Number of items won | {{ ItemsWon_Count }} |
| Number of purchases | {{ Purchases_Count }} |
| Number of donations | {{ Donations_Count }} |
| Number of payments | {{ Payments_Count }} |
Word document templates also include {{ Balance }} and {{ TaxDeductibleAmount }}.
Example messages
Welcome email (built in the email editor, so it uses the full form)
Hi {{ Bidder.GreetingNames }},
Thanks for registering! You're seated at Table {{ Bidder.Table }}, and your Paddle# is {{ Bidder.Number }}.
To speed up checkout, add a credit card here: {{ Bidder.RegisterCreditCardUrl }}
Checkout reminder text (text messages accept either form)
Hi {{ FirstName }}, thanks for coming tonight! Add a card now for faster checkout: {{ ShortRegisterCreditCardUrl }}