Back

Job role name variable in document templates

Learn how to effectively incorporate job role name variables into document templates for improved personalization and efficiency.

Table of Contents

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?

  1. Go to Documents
  2. Access the Templates tab
  3. Open an existing template or create a new one in +Add new template
  4. In the list of variables, look for Job title
  5. 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

  1. 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.
     
  2. Can I continue using job levels in documents?
    Yes. If your organisation uses formal levels, you can continue using {{job_position}} in your templates.
     
  3. Where does the value come from?
    The value is pulled from the employee’s assigned role in the Job Catalog.
{{job_role_name}}
 

Was this article helpful?

Give feedback about this article

Can’t find what you’re looking for?

Our customer care team is here for you.

Contact us

Knowledge Base Software powered by Helpjuice