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. |
[[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. |
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 start date of that campaign. If being sent to a user, it will show the day they are enrolled. |
[[training_campaign_end_at]] | Training Campaign End At | To be used with user notifications only, displays the due date for that campaign and/or user. If no due date or end date, will display as (No End Date). |
[[training_campaign_days_remaining]] | Training Campaign Days Remaining | To be used with user notifications only, displays the number of days remaining before that user's due date. If there is no due date or end date, will display as (Unlimited). |
[[signup_link]] | Signup Link |
To be used with user notifications only, displays the URL that your user will need to activate their account and/or log in for training assignments. You must have your "Allow Users to Signup" setting checked "on" in your Account Settings to allow users to sign up for accounts on their own. This placeholder does not use HTML and is not in the Placeholder drop-down selection. |
[[days_overdue]] | Overdue Days |
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. (See here 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 through the campaign. Displayed line by line. Previous version, still supported: [[course_list]] |
[[incomplete_assignment_list]] |
Incomplete Assignments List |
To be used with user notifications only, displays all incomplete assignments associated with that training campaign and/or user. Displayed line by line. Previous version, still supported: [[incomplete_course_list]] |
[[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". Previous version, still supported: [[course_list_count]] |
[[incomplete_assignment_list_count]] |
Incomplete Assignments Count | To be used with user notifications only, displays the number of incomplete assignments associated with that training campaign and/or user. Displayed as "X Assignments". Previous version, still supported: [[incomplete_course_list_count]] |
[[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 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 the user has not completed before the due date. (See here for more on past due training assignments.) |
[[extended_due_date]] |
Extended Due Date |
To be used with manual Past Due user notifications only, displays the user's new due date if this has been extended by an account admin or training campaign admin. |
[[user_list]] | User List | To be used with manager and admin notifications only, this displays a list of the affected users, line by line, formatted as "Email, Full Name". |
[[user_email_list]] | User Emails | To be used with manager and admin notifications only, this displays a list of the affected users' email addresses, line by line. |
[[user_fullname_list]] | User Names | To be used with manager and admin notifications only, displays affected users' first and last names. |
[[user_list_count]] | Total Users Count | To be used with manager or admin notifications only, displays the number of affected users, depending on the type of notification used. |
[[password-less_login_link]] | Password-less Login Link |
To be used with user notifications only, this displays a unique, clickable link to let users instantly log in to complete their assignments. 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 Login Link Duration | To be used with user notifications only, this 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.