Email Variables
Variables allow you to personalize emails by inserting dynamic content. This reference covers all available variables.
How Variables Work
Variables are placeholders in templates:
- Written as
{{variable_name}} - Replaced with actual values when sent
- Different values for each recipient
Global Variables
Available in all templates:
| Variable | Description | Example |
|---|---|---|
{{current_date}} | Today's date | January 15, 2025 |
{{platform_name}} | Platform name | Matchpal |
{{support_email}} | Support contact | support@example.com |
Student Variables
For emails to or about students:
| Variable | Description |
|---|---|
{{student_name}} | Student's full name |
{{student_first_name}} | Student's first name |
{{student_email}} | Student's email address |
{{student_phone}} | Student's phone number |
Provider Variables
For emails to or about providers:
| Variable | Description |
|---|---|
{{provider_name}} | Provider's full name |
{{provider_first_name}} | Provider's first name |
{{provider_email}} | Provider's email address |
Relationship Variables
For relationship-related emails:
| Variable | Description |
|---|---|
{{relationship_id}} | Unique relationship ID |
{{service_type}} | Tutoring or Advising |
{{allocated_hours}} | Hours allocated |
{{remaining_hours}} | Hours remaining |
Session Variables
For session-related emails:
| Variable | Description |
|---|---|
{{session_date}} | Date of the session |
{{session_time}} | Time of the session |
{{session_duration}} | Length of session |
Billing Variables
For billing-related emails:
| Variable | Description |
|---|---|
{{grant_balance}} | Current grant balance |
{{package_name}} | Package purchased |
{{hours_used}} | Hours consumed |
Link Variables
For actionable emails:
| Variable | Description |
|---|---|
{{login_link}} | Link to log in |
{{proposal_link}} | Link to view proposal |
{{dashboard_link}} | Link to dashboard |
Using Variables
In Subject Lines
Session reminder: {{session_date}} with {{provider_name}}
In Body Content
Hello {{student_first_name}},
Your balance is now {{grant_balance}} hours.
Log in to view details: {{login_link}}
Variable Availability
Not all variables work in all contexts:
- Session variables only in session emails
- Relationship variables only when a relationship exists
- Check context when selecting variables
Troubleshooting
Variable Not Replacing
- Check syntax:
{{variable_name}} - Verify variable is available for that template type
- Ensure data exists for the recipient
Missing Data
If a variable has no value:
- May show as blank
- Or show placeholder text
- Check recipient's profile data
Related Documentation
- Email Templates - Creating templates
- Email Overview - System overview
- Email System - Admin management