Overview
Macros let you personalize the text inside your training modules — automatically inserting the right name, company detail, or date for each learner when they view the module.
How to add a macro to a training module
Find the macro you want in the reference table below.
Copy the macro key exactly as written.
Paste it into the text content of your training module.
Add a fallback value if required (see Fallback values section below).
Preview the module to confirm the macro resolves correctly before publishing.
Fallback values
Some macros depend on data that may not be filled in for every employee. For example, a manager's name or department. These are marked Fallback Required (✅) in the tables below.
When the data is missing, the macro renders as blank text. To avoid this, add a fallback value using | default: '[your text]' inside the macro:
{{manager.name | default: 'your manager'}}
In this example, if the learner has a manager assigned, the macro displays their manager’s name. If not, it displays "your manager" instead.
Available macros for training modules
Macros marked ✅ require a fallback value — see Fallback values section above.
Employee info
Where to find these values: Employee information is set under Workspace > Employees.
Macro | Description | Example output | Fallback Required? |
| Learner's first name | Leah |
|
| Learner's first + last name | Leah Stewart | ✅ |
| Learner's email address | ✅ | |
| Learner's department | Product | ✅ |
| Learner's location | NYC | ✅ |
| Microsoft vs Gmail | Microsoft | ✅ |
| Email domain without .com | adaptivesecurity | ✅ |
| First + last initial | LS | ✅ |
| Learner's organization | Adaptive | ✅ |
| Personal training link | ✅ |
Company info
Where to find these values: Company information is set under Settings > Company Profile.
Macro | Description | Example output | Fallback required? |
| Company name | Adaptive Security |
|
| Company city | New York |
|
| Executive full name | Brian Long |
|
| Executive first name | Brian |
|
| Security reporting instructions | Reach out to [email protected]. |
|
| Security contact email |
| |
| Company website domain | adaptivesecurity.com |
|
| Typo variant of company domain | kicks.com [rather than knicks.com] |
|
| Company logo URL |
| |
| Executive first name, lowercase | brian |
|
| Executive full name, lowercase, no space | brianlong |
|
| Company admin URL |
| |
| Executive deepfake audio URL |
|
Manager info
Where to find these values: Each employee’s manager info is set under Workspace > Employees > Direct Manager field.
Macro | Description | Example output | Fallback required? |
| Learner's manager full name | Andrew Jones | ✅ |
| Learner's manager first name | Andrew | ✅ |
| Learner's manager email | ✅ |
Relative time
Macro | Description | Example output | Fallback required? |
| Today's date | 1/1/26 |
|
| Yesterday | 12/31/25 |
|
| Tomorrow | 1/2/26 |
|
| One week ago | 12/25/25 |
|
| One week from now | 1/8/26 |
|
| Current time | 12:00 PM |
|
| One hour ago | 11:00 AM |
|
| One hour from now | 1:00 PM |
|
Tips
Preview before publishing. Click Preview on your module overview page to confirm all macros resolve correctly and no values appear blank.
Always add fallbacks for macros marked Fallback Required. If a field isn't populated for an employee, the macro will render blank for users taking the training.
Only use macros from the list above. Any other macro key will render as an empty string.
