The {{job_role_name}} variable allows you to display only the employee’s job role name in document templates, without including the job level. This helps create cleaner and more accurate documents for companies that do not use formal job levels in their organisational structure.
With this variable, you can choose whether to display the complete job position or only the role name in contracts, onboarding documents, and other templates.
Overview
The new {{job_role_name}} variable retrieves only the role name configured in the Job Catalog and excludes the assigned level.
This is especially useful for companies that:
- Do not use formal job levels
- Use generic placeholder levels such as “I” or “General”
- Want more professional and accurate employee documentation
For example:
| Job Catalog field | Value |
|---|---|
| Role | Software Engineer |
| Level | II |
Using:
-
{{job_position}}→ Software Engineer II -
{{job_role_name}}→ Software Engineer
How does it work?
- Go to Documents
- Access the Templates tab
- Open an existing template or create a new one in +Add new template
- In the list of variables, look for Job title
- This variable returns only the role name from Job Catalog, excluding the level


If the variable does not display any value, make sure the employee has a job role assigned in the Job Catalog.
If the document still shows the level, check that the template uses {{job_role_name}} instead of {{job_position}}.
Tips and best practices
- Use
{{job_role_name}}when creating:- Employment contracts
- Onboarding documents
- Offer letters
- Internal HR templates
- Use
{{job_position}}if your company uses structured job levels and you want them included in documents. - Preview templates before sending documents to employees to ensure the displayed information matches your company structure.
FAQ
-
What is the difference between
{{job_position}}and{{job_role_name}}?{{job_position}}includes both the role name and the level, while{{job_role_name}}only includes the role name.
-
Can I continue using job levels in documents?
Yes. If your organisation uses formal levels, you can continue using{{job_position}}in your templates.
-
Where does the value come from?
The value is pulled from the employee’s assigned role in the Job Catalog.
{{job_role_name}}