For organisations using HRStop Payroll, employee salary structures are already configured within the system. HRStop provides a set of special placeholders that automatically pull this salary data into document templates, eliminating the need to manually configure custom key formulas. This article explains these payroll-linked salary placeholders and when to use them in your document templates.
Before You Begin
Before using payroll-linked salary placeholders, ensure the following:
- The employee is mapped to a salary template in HRStop Payroll
- The employee’s master salary is configured in the system
- You understand how placeholders work in document templates. Refer to: Using Customer Keys (Placeholders) in Document Templates
Payroll-Linked Salary Placeholders
Unlike standard Custom Keys that require formula configuration, these placeholders directly reference the employee’s salary data maintained in HRStop Payroll. When the document is generated, the placeholder is automatically replaced with a fully formatted salary table — no manual CTC input required.
| Placeholder | Description | Applicable Letters |
|---|---|---|
| {{Salary.TabularData}} | Automatically generates the complete current salary breakup table based on the employee’s configured salary in HRStop Payroll | Appointment Letter, Confirmation Letter, Offer Letter |
| {{MonthlySalary.TabularData}} | Same as above but displays salary components in monthly figures instead of annual breakup | Appointment Letter, Confirmation Letter, Offer Letter |
| {{PreviousSalary.TabularData}} | Generates the salary table showing the employee’s last salary values prior to the most recent appraisal. Requires at least one salary appraisal to have been processed in HRStop Payroll | Appraisal Letter, Increment Letter |
| {{CombineSalary.TabularData}} | Generates a combined table showing both the previous and current salary side by side. Data is pulled from HRStop’s salary appraisal history. Requires at least one salary appraisal to have been processed in HRStop Payroll | Appraisal Letter, Increment Letter |
HRStop may provide additional salary-related placeholders as the Payroll module evolves. For the latest list of available keys, refer to the placeholder library within the Document Template configuration screen.
How It Works
When a document is generated for an employee:
- The system identifies the salary template the employee is mapped to
- It retrieves the configured salary components and values for that employee
- The placeholder is automatically replaced with a fully formatted salary table in the generated document
- For {{CombineSalary.TabularData}} and {{PreviousSalary.TabularData}}, the system pulls data from the employee’s salary appraisal history maintained in HRStop Payroll
Important Notes
- These placeholders will only populate correctly if the employee is mapped to a salary template and master salary is configured in HRStop Payroll. If salary data is not available, the placeholder will remain blank in the generated document.
- For {{PreviousSalary.TabularData}} and {{CombineSalary.TabularData}} to work correctly, at least one salary appraisal must have been processed for the employee in HRStop Payroll.
- If employee salary is not yet configured in HRStop Payroll, use the manual CTC formula approach to set up your template. Refer to: Setting Up an Appointment Letter Template with CTC Salary Breakup
- For guidance on entering CTC manually at the time of generation, refer to: Generating Salary Letters by Entering CTC