Using Placeholders to Personalize Phishing Templates, Landing Pages, and Training Notifications
You can use various placeholders to act as dynamic text entry for your phishing emails, training notifications, and landing pages. For phishing templates and training notifications, this works similar to a mail merge and will automatically populate the email content with the placeholder field you specify.
On your phishing campaigns, this ability to target and spear-phish your users will make your phishing tests more difficult.
Important
In order to use the placeholders below, you must have the corresponding information imported into the user's profile or the organization's profile.
To use the Account Information Placeholders, be sure to complete the account owner's Account Settings and double-check that your organization's information is correct. As an admin, you can review and update this information by clicking on your email address on the top-right of the screen and then clicking on Account Settings.
For the User Information Placeholders, you should only attempt to use fields that have been imported or added to the user's page. However, if the column for a certain field is empty on the user's page, the placeholder will simply show a blank space when the user receives the email.
Jump to:
Account Information Placeholders (Company-Specific)
User Information Placeholders (User-Specific)
Training Information Placeholders (Training Only)
Miscellaneous Placeholders
| Account Information Placeholders | ||
| The following company-specific information can be used if the fields are completed in the Account Owner's Account Settings: | ||
| Placeholder | Placeholder Drop-Down Selection | What it Populates |
| [[domain]] | Domain |
The email recipient's domain, as in "yourdomain.com" (Example: knowbe4.com). If you have multiple domains on your account, the placeholder will display each recipient's respective domain. This placeholder does not exist in the drop-down selection. However, [[domain]] can be used anywhere in templates. If you do not want to spoof your recipients' domains, you can set another domain to use instead when this placeholder is used in phishing templates and landing pages. You can do this from your Account Settings page. |
| [[company_logo_img]] | Company Logo Image |
Your company's logo as indicated in the company logo URL in your Account Settings. This placeholder uses HTML to display your company logo automatically. |
| [[company_logo_url]] | Company Logo URL |
Your company logo's URL if a logo URL is provided in your Account Settings. This placeholder should only be used in an <img> tag, or with our WYSIWYG "image" button to add your logo URL automatically. |
| [[company_name]] | Company Name | Your company's name. |
| [[brand_color]] | Brand Color |
The hex code of your organization's brand color, if the color was set in Account Settings. This placeholder should only be used within the source code of landing pages, training notifications, and email templates. Do not use this placeholder in the WYSIWYG editor view. For more information see our article titled How do I Use the Branded Landing Pages, Training Notifications, and Email Templates? |
|
[[street_address_1]] [[street_address_2]] |
Street Address 1 Street Address 2 |
Your company's street address. |
| [[suite_number]] | Suite Number | Your company's suite number if indicated in your Account Settings. |
| [[city]] | City | Your company's city. |
| [[state]] | State | Your company's state. |
| [[zip_code]] | Zip Code | Your company's zip code. |
| [[account_phone_number]] | Company Phone | Your company's phone number. |
| [[email_banner]] | Email Banner |
Your organization's email banner. The banner can be used for just text or include source code to emulate your organization's official email banner. This placeholder can be customized and set to appear on phishing emails automatically from your Account Settings page. |
| [[signature]] | Signature Block |
Your organization's signature block. The signature can be used for just text or include source code to emulate your organization's official email banner. This placeholder can be customized and set to appear on phishing emails automatically from your Account Settings page. |
| User Information Placeholders | ||
| The following are user-specific placeholders. Data must be complete in the user profile to use these fields: | ||
| Placeholder | Placeholder Drop-Down Selection | What it Populates |
| [[email]] | Recipient's email. (Can be user, manager, or admin) | |
| [[first_name]] | First Name |
Recipient's first name. (Can be user, manager, or admin) |
| [[last_name]] | Last Name |
Recipient's last name. (Can be user, manager, or admin) |
| [[display_name]] | Display Name |
Displays first and last name of the email recipient. If the first and last name fields in the user's profile are blank, it will use their email instead. |
| [[job_title]] | Job Title | User's job title. |
| [[phone_number]] | Phone Number | User's phone number. |
|
[[extension]] |
Extension | User's extension. |
| [[location]] | Location | User's location. |
| [[division]] | Division | User's division. |
| [[manager_name]] | Manager Name |
User's manager. |
| [[manager_email]] | Manager Email | The email address for that user's manager. |
| [[employee_number]] | Employee Number | User's employee number. |
Note for using [[manager_name]] in training notifications: A user's manager's first and last name is determined by the Manager Name field in a user's account information. When using this placeholder, the email recipient's manager's name will populate.
When creating training notifications to send to managers: Use the [[first_name]] and [[last_name]] placeholders to address the manager who is receiving the email, by name.
| Training Information Placeholders | ||
| The following are special placeholders to use with Training Campaign Notifications only. | ||
| Training Campaign Notification placeholders can only be used in the body of a template. | ||
| Placeholder | Placeholder Drop-Down Selection | What it Populates |
| [[training_campaign]] | Training Campaign | The name of the training campaign. |
| [[training_campaign_start_at]] | Training Campaign Start At | To be used with user notifications only, displays the date when the user was enrolled in the training campaign. |
| [[training_campaign_end_at]] | Due Date | To be used with user notifications only, displays the date all the training content in the training campaign needs to be completed by. If there is no due date or end date, the placeholder will display as (No End Date). |
| [[training_campaign_days_remaining]] | Number of days remaining in training campaign. | To be used with user notifications only, displays the number of days remaining in the associated campaign before the user's training is due. If there is no due date or end date, the placeholder will display as (Unlimited). |
| [[days_overdue]] | Number of days training is overdue. |
To be used with Past Due user notifications only, displays the number of days that have passed since that user's training assignments were due for the associated campaign. (See our How to Modify Training Deadlines article for more on past due training assignments.) |
| [[login_link]] | Login Link |
To be used with user notifications only, displays the URL that your user will need to log in for training assignments. This placeholder does not use HTML. |
|
[[assignment_list]] |
Assignments List |
To be used with user notifications only, displays all assignments assigned to the user as part of the associated campaign. These assignments are listed out line by line. The previous version of this placeholder, [[course_list]], is still supported. |
|
[[incomplete_assignment_list]] |
Incomplete Assignments List |
To be used with user notifications only, displays a list of all of the user's incomplete assignments associated with that campaign. These assignments are listed out line by line. The previous version of this placeholder, [[incomplete_course_list]], is still supported. |
|
[[assignment_list_count]] |
Assignments List Count |
To be used with user notifications only, displays the number of assignments in that campaign. Displayed as "X Assignments". The previous version of this placeholder, [[course_list_count]], is still supported. |
|
[[incomplete_assignment_list_count]] |
IncompleteAssignmentsCount | To be used with user notifications only, displays the number of incomplete assignments associated with that campaign. Displayed as "X Assignments". The previous version of this placeholder, [[incomplete_course_list_count]], is still supported. |
|
[[pastdue_assignment_list]] |
Past Due Assignments |
To be used with Past Due user notifications only, displays all of the assignments the user has not completed in the associated campaign before the due date. |
|
[[pastdue_assignment_list_count]] |
Past Due Assignments Count | To be used with Past Due user notifications only, displays the number of assignments in the associated campaign that the user has not completed before the due date. Displayed as "X Assignments". (See our How to Modify Training Deadlines article for more on past due training assignments.) |
|
[[extended_due_date]] |
Extended Due Date |
Only use this place holder for manual, past due, user notifications that are sent after extending the training deadline of a user. This placeholder will display the user’s new training due date, based on the extended deadline. If a training campaign includes multiple assignments, and some of them have already been completed, this placeholder may not populate correctly. For best results, extend the due date of all assignments within the campaign. |
| [[user_list]] | Relevant User Emails and Names | To be used with manager and admin notifications only, displays a list of relevant users enrolled in the campaign, line by line. Formatted as "Email, Full Name". |
| [[user_email_list]] | Relevant User Emails | To be used with manager and admin notifications only, displays a list of email addresses for relevant users enrolled in the campaign, line by line. |
| [[user_fullname_list]] | Relevant User Names | To be used with manager and admin notifications only, displays the first and last names of relevant users enrolled in the campaign. |
| [[user_list_count]] | Relevant Users Count | To be used with manager or admin notifications only, displays the number of relevant users enrolled in the campaign, depending on the type of notification used. |
| [[password-less_login_link]] | Password-less Link |
To be used with user notifications only, displays a unique, clickable link to let users instantly log in to the Learner Experience. You must have password-less logins enabled in your Account Settings to use this placeholder. This placeholder does not use HTML. |
| [[password-less_link_duration]] | Password-less Expires In | To be used with user notifications only, displays the number of days left before the password-less login link expires. You must have password-less logins enabled in your Account Settings to use this placeholder. |
| Miscellaneous Placeholders | ||
| Placeholder | Placeholder Drop-Down Selection | What it Populates |
| [[random_number_1]] | Random Number (1 Digit) |
One randomly-generated digit. You can manually replace the digit-count number in this placeholder with 4, 5, 6, 7, 8, or 9 to generate a longer, randomly-generated number. Not available for training notifications. |
| [[random_number_2]] | Random Number (2 Digits) |
Two randomly-generated digits. You can manually replace the digit-count number in this placeholder with 4, 5, 6, 7, 8, or 9 to generate a longer, randomly-generated number. Not available for training notifications. |
| [[random_number_3]] | Random Number (3 Digits) |
Three randomly-generated digits. You can manually replace the digit-count number in this placeholder with 4, 5, 6, 7, 8, or 9 to generate a longer, randomly-generated number. Not available for training notifications. |
| [[current_date_0]] | Current Date | Displays the date the email was sent to the recipient's inbox, in Month DD, YYYY format (e.g., July 4, 2018). |
| [[current_date_10]] | Current Date + 10 days |
Displays the date it will be 10 days after the email is sent to the recipient's inbox, in Month DD, YYYY format. For example, if the email is sent on July 4, 2019, this placeholder will display July 14, 2019. You can manually replace the "+ day" number in this placeholder to change the increment of days added to the current date. For example, if you want the placeholder to display the date five days from now, change it to [[current_date_5]]. |
| [[current_date_-10]] | Current Date - 10 days |
Displays the date it was 10 days prior to the date the email was sent to the recipient's inbox, in Month DD, YYYY format. For example, if the email is sent on July 4, 2018, this placeholder will display June 24, 2018. Note: You can manually replace the "- day" number in this placeholder to change the increment of days subtracted from the current date. For example, if you want the placeholder to display the date from five days ago, change it to [[current_date_-5]]. |
| [[knowbe4_domain]] | Unavailable in drop-down |
This placeholder populates the KnowBe4 domain. While [[domain]] populates the email recipient's domain, [[knowbe4_domain]] populates the KnowBe4 domain. Example: donotreply@[[knowbe4_domain]] will appear as donotreply@training.knowbe4.com or donotreply@eu.knowbe4.com, depending on where your KnowBe4 account is located. |
Comments
0 comments
Article is closed for comments.