Why Tokens 🖐
One of the things that makes Táve so powerful 💪 is your templates. In order for templates to be powerful, you'll want to build out some of these templates with placeholders where your clients' data will go. In Táve, we call these Tokens.
Tokens can be used in emails, contracts, and questionnaires to quickly personalize documents and emails for everyone you work with, without having to create them from scratch for every client. If that's not enough time-saving power for you, you can even use them in automations.
Understanding Tokens
Every token will begin with a prefix telling you what that token is for. It's important to make sure you have the right prefix when you're using tokens as this tells Táve where to get the information from. An example would be {{bride.name}}, which would be a placeholder for the full name of the bride. 👰 Once you have your prefix selected, grab the token you want to use, use it as a placeholder, and Táve will automatically fill it with the information you've previously gathered in Táve.
Existing Tokens
People
Every job role in your Táve account will have a set of tokens attached to it by default. Here's a list of some of the popular ones below. There are a lot more and you can see a full list of all standard contact tokens here. In this case xxx = Job Role Prefix (i.e. Bride, Groom, etc.).
{{xxx.address}} - The address of the contact
{{xxx.birthday}} - The birthday of the contact
{{xxx.cell_phone}} - The cell phone number of the contact
{{xxx.company_name}} - The company name of the contact
{{xxx.custom.[custom-field-token]}} - Any custom fields you've created for contacts will show here
{{xxx.email}} - The email address of the contact
{{xxx.first_name}} - The first name of the contact
{{xxx.home_phone}} - The home phone number of the contact
{{xxx.instagram_url}} - The Instagram URL of the contact
{{xxx.last_name}} - The last name of the contact
{{xxx.maiden_name}} - The maiden name of the contact
{{xxx.mailing_address}} - The mailing address of the contact
{{xxx.name}} - The full name of the contact
{{xxx.portal_linked}} - A link for this contact's Client Portal
{{xxx.school_name}} - The school name of the contact
{{xxx.url}} - The URL of the contact's website
{{xxx.work_phone}} - The work phone number of the contact
Recipient Tokens
When you're sending an email, sometimes the job role can vary a bit depending on who the recipient of the email is. In Táve we have tokens just for recipients. To help, you can replace xxx with 'recipient' to use any of the above tokens for each recipient of the email. 💪
Events
Every event type in your Táve account will have a set of tokens attached to it by default. Here's a list of some of the popular ones below. There are a lot more and you can see a full list of all tokens here. In this case xxx = Event Type Prefix (i.e. Wedding Ceremony, Wedding Reception, etc.).
{{xxx.attendees}} - A comma separated list of all attendees
{{xxx.attendees_clients}} - A comma separated list of all attendees that are clients
{{xxx.attendees_clients_subjects}} - A comma separated list of all attendees that are clients or subjects
{{xxx.attendees_subjects}} - A comma separated list of all attendees that are subjects
{{xxx.attendees_team}} - A comma separated list of all attendees that are team members
{{xxx.duration}} - The duration of the event (XX hours, XX minutes)
{{xxx.end}} - The end of the event. IE - 'MM/DD/YYYY @ HH:MMam/pm' (Can change depending on account settings)
{{xxx.end_date}} - The end date of the event. IE- 'MM/DD/YYYY' (Can change depending on account settings)
{{xxx.end_date_long}} - The end date of the event (DAY OF WEEK, MONTH DAY, YEAR)
{{xxx.end_time}} - The end time of the event (HH:MMam/pm)
{{xxx.address}} - The address of the event
{{xxx.location.name}} - The name of the location for the event
{{xxx.location.phone}} - The phone number for the location for the event
{{xxx.map_link}} - The location name linked to the location on Google Maps
{{xxx.map_url}} - A link to the location on Google Maps
{{xxx.name}} - The name of this event
{{xxx.notes}} - Any notes you've taken for this specific event
{{xxx.start}} - The start of the event IE - 'MM/DD/YYYY @ HH:MMam/pm' (Can change depending on account settings)
{{xxx.start_date}} - The start date of the event IE- 'MM/DD/YYYY' (Can change depending on account settings)
{{xxx.start_date_long}} - The start date of the event (DAY OF WEEK, MONTH DAY, YEAR)
{{xxx.start_time}} - The start time of the event (HH:MMam/pm)
{{xxx.sunrise}} - The time of sunrise at the location address for the event's date
{{xxx.sunset}} - The time of sunset at the location address for the event's date
Primary Session
Some types of jobs have one event that is the main event. In Táve we call that the Primary Session. To help, you can replace xxx with 'primary_session' to use any of the above tokens for the Job's Primary Session. 💪
Other Helpful Tokens
Jobs
Every job in your Táve account will have a set of tokens attached to it by default. Here's a list of some of the popular ones below. There are a lot more and you can see a full list of all tokens here. These will always fill with information from the brand this job is assigned to.
{{job.balance}} - The remaining balance on a job ($2,490.00)
{{job.clients}} - The names of all clients on the job (Meghan Christian and Matt Fields)
{{job.clients.first_names}} - The first names of all clients on the job (Meghan and Matt)
{{job.clients_team}} - The names of all team members on the job (Erin and Elyssa)
{{job.custom.[custom-field-token]}} - Any custom fields you've created for contacts will show here
{{job.date}} - The date of the job. This will always match the same date as the primary session. (8/26/2024)
{{job.date_long}} - The date of the job in long format (Monday, August 26th, 2024)
{{job.everyone}} - A list of every contact's full name listed on this job (Meghan Christian, Matt Fields, and Judy Hernandez)
{{job.everyone.first_names}} - A list of every contact's first name listed on this job (Meghan, Matt, and Judy)
{{job.name}} - The full name of this job. If no custom name has been set, it will default to Client Name + Job Type + Long Date (Matt Fields and Meghan Christian's Destination Wedding Photography on Monday, August 26th, 2024)
{{job.name_only}} - The abbreviated name of this job. If no custom name has been set, it will default to Client Name + Job Type (Matt Fields and Meghan Christian's Destination Wedding Photography)
Brand
Every brand in your Táve account will have a set of tokens attached to it by default. Here's a list of some of the popular ones below. There are a lot more and you can see a full list of all tokens here. These will always fill with information from the brand this job is assigned to. If you're using the tokens for your default brand, you would adjust this in main settings, otherwise you can change this in the settings for that brand.
{{brand.email}} - The email address for this brand
{{brand.email_signature}} - The email signature for this brand
{{brand.location}} - The address for this brand
{{brand.name}} - The name of this brand
{{brand.office_hours}} - The office hours for this brand
{{brand.primary_website}} - The website for this brand
{{brand.phone_label_1}} - The label of the phone 1 for this brand (screenshot below)
{{brand.phone_number_1}} - The phone number 1 for this brand (screenshot below)
Item Tokens (Quotes, Questionnaires, Contracts, Invoices and Orders)
Email in Táve is powerful, and part of that power is the ability to create templates that include links to some of our most powerful features. Here's a list of some of the popular tokens below. There are a lot more and you can see a full list of all tokens here.
Item Tokens
Use these tokens to link your clients to their Quotes, Questionnaires, Contracts, Invoices and Orders. To use these, you'll want to make sure you're using the right email type. Check out the Email Templates article here to see which types show up where in Táve.
{{item.link_start}}
{{item.link_end}}
{{item.link_url}}
{{item.name}}
{{item.name_link}}
Those item links tokens will link to the item the email is Referencing.
Creating Additional Tokens
A lot of tokens will be created for you, so you shouldn't need to create too many early on, but there are a few ways you can add tokens into your Táve account. Creating a new Job Role, Event Type, or Custom Field will create an entire set of tokens with it, saving you the process of setting them all up one by one. 😊