In this article, you will learn which variables to use for the Site/Course/Bundle Welcome Email, and gain an understanding of the different variables available for each type of email notification.
In this article:
How to Use Email Variables
You can use Email Variables in your Personalized Email Notifications to have data automatically populate based on the information of the student who receives the email.
- For example, using
{{user.first_name}}
in your Site Welcome Email will automatically replace the variable with the name of the student.
This article will cover how Email Variables differ for the Site Welcome Email, Course Welcome Email and Bundle Welcome Email.
Site Welcome Email
The variables used in Site Welcome Emails will be in the format {{user.full_name}}, with most containing a period and an underscore.
The variables available are shown in the article on Site Welcome Emails linked above, as well as under the site welcome email editor (which you can access by clicking on Support Your Students, selecting Notifications, clicking Site welcome, and selecting Edit).
Variables include:
{{user.full_name}}
- Inserts first name and last name{{user.first_name}}
- Inserts first name only{{user.last_name}}
- Inserts last name only{{user.email}}
- Inserts the email address{{sign_in_url}}
- Inserts the URL a user can go to in order to sign in to your course site{{site_name}}
- Inserts the name of your course site{{express_sign_in_url}}
- Inserts the user's Express Sign In URL. If no password was created yet, this will prompt them to set a password.
Course Welcome Email
The variables used in Course Welcome Emails will be in the format {{user_full_name}}, with most containing two underscores.
The variables available are shown in the guide linked above, as well as under the course welcome email editor ((which you can access by clicking on Support Your Students, selecting Notifications, clicking Course welcome email, and selecting Edit).
Variables here include:
{{user_full_name}}
- Inserts first name and last name{{user_first_name}}
- Inserts first name only{{user_last_name}}
- Inserts last name only{{user_email}}
- Inserts the email address{{course_name}}
- Inserts the name of the course{{site_name}}
- Inserts the name of your school{{site_url}}
- Inserts your site URL{{sign_in_url}}
- Inserts a link to your sign-in page{{edit_notifications_url}}
- Inserts a link to update notification preferences{{instructor_full_name}}
- Inserts the instructor's first name and last name{{instructor_first_name}}
- Inserts the instructor's first name{{instructor_last_name}}
- Inserts the instructor's last name{{course_link}}
- Inserts a link to the course{{course_review_link}}
- Inserts a link to Course Reviews{{express_sign_in_url}}
- Inserts the user's Express Sign In link to allow them to set a password
Bundle Welcome Email
The Bundle Welcome Email variables will be mostly the same as in course welcome emails, with some extra variables included:
{{bundle_name}}
- Inserts the name of the bundle{{% exceeds_course_limit %}}
- Learn more about how to use this variable in the Bundle Welcome Email article
You can also include course variables in your bundle welcome email by adding them within this loop:{% for course in courses %}
add course variables here
{% endfor %}
This will print the variables you've added for each course within the bundle.
Mass User Emails
Although Mass User Emails are not specifically "notification" type emails (in that they are not sent automatically and rather, are sent manually), they do still have a similar set of variables and have therefore been included in this article.
The variables used in Mass User Emails will be in the format {{full_name}}, with most containing an underscore.
The variables available are shown in the article on Mass User Emails linked above. Simply follow the steps within the article to access the Mass User email editor.
Variables include:
{{full_name}}
- Inserts first name and last name{{first_name}}
- Inserts first name only{{last_name}}
- Inserts last name only{{email}}
- Inserts the email address
Important Considerations
- Using the incorrect variable will print the variable as text in the email, instead of populating the data.
- For example: In a Site Welcome Email, adding
{{user.full_name}}
will insert the first name and last name of the student into the email. If you used the{{user_full_name}}
variable (which is meant for a Course or Bundle Welcome Email), the student would see the text "{{user_full_name}}" instead of their full name.
- For example: In a Site Welcome Email, adding