Using Email Template Tags in Testlify
Before you begin
- You must have Admin or Owner access to your Testlify workspace.
- Open Settings > Notification > Email notifications to access your email templates.
Access Email Notification Templates
From your workspace, go to Settings > Notification > Email notifications.

Customize a Template
- Locate the template you want to edit.
- Click the 3-dot menu ( ⋮ ) next to it.
- Select Customize to open the template editor.
- Paste one or more tags from the reference table below into the email body or subject line.
- Click Save to apply your changes.

Available Template Tags
Paste any tag below directly into your email template. Testlify automatically replaces it with the correct value when the email is sent.
Tip: Tags that include a button label — such as {ASSESSMENT_START_BUTTON: Take assessment now} — let you customize the button text. Replace the text after the colon with any label you prefer.
| Tag | Description |
{USER_NAME} |
First name of the user |
{USER_FIRST_NAME} |
First name of the logged-in user |
{USER_LAST_NAME} |
Last name of the logged-in user |
{CANDIDATE_FIRST_NAME} |
Candidate's first name |
{CANDIDATE_LAST_NAME} |
Candidate's last name |
{ASSESSMENT_URL} |
URL of the assessment |
{ASSESSMENT_NAME} |
Name of the assessment |
{CEFR_PDF_REPORT_BUTTON: Download CEFR report} |
Button to download the English CEFR candidate report. Replace Download CEFR report to use a custom button label. |
{ASSESSMENT_EXPIRY_DATE_TIME} |
Date and time the assessment link expires |
{CANDIDATE_ALL_PDF_REPORT_ZIP: All reports} |
Button to download all assessment reports as a ZIP file. Replace All reports to use a custom button label. |
{ASSESSMENT_RESULT_BUTTON: Assessment Report} |
Button to download the assessment result. Replace Assessment Report to use a custom button label. |
{ASSESSMENT_START_BUTTON: Take assessment now} |
Button to start the assessment. Replace Take assessment now to use a custom button label. |
{CANDIDATE_GRADING} |
Candidate's grade as configured in the assessment settings |
{SHAREABLE_RESULT_URL} |
Shareable link to view the full candidate report |
{ASSESSMENT_PRACTICE_URL} |
URL that redirects to the practice assessment |
{CANDIDATE_AVERAGE_SCORE} |
Candidate's average score, excluding "to be scored" or manually graded questions |
{ASSESSMENT_ACCOMMODATION_URL} |
URL that redirects to the accommodation request form |
{WORKSPACE_NAME} |
Name of the workspace |
{WORKSPACE_SUPPORT_EMAIL} |
Support email from workspace settings (defaults to support@testlify.com if not configured) |
{CANDIDATE_ASSESSMENT_REPORT_PDF} |
URL that redirects to the candidate result PDF |
{TEST_1_PDF_REPORT_BUTTON: Download Test 1 Report} |
Button to download a specific test report by position. Use {TEST_1_PDF_REPORT_BUTTON: Download Test 1 Report}, {TEST_2_PDF_REPORT_BUTTON: Download Test 2 Report}, and so on for each test. Replace Download Test 1 Report to use a custom button label. |
{ASSESSMENT_SETTING} |
Link to the settings page to extend the validity of a candidate's assessment link |
Need help? Contact support.