Getting started
Who can access Salary revisions?
Role | What they can do |
Superadmin | Full access — create rounds, manage groups, start revisions, apply salaries |
Reviewer | View assigned groups, enter salary adjustments, submit for approval |
Approver | View assigned groups, approve or reject submitted salary proposals |
Regular admin users have no special access to salary revisions unless they are assigned as a reviewer or approver. Employees without either role have no access at all.
How to access
Navigate to Admin portal > Salary Revisions. The feature has its own sidebar listing all revision rounds, grouped by year, with any drafts shown at the top.
Creating a Salary revision round
Click the + button in the sidebar.
Choose a template:
Template | Description |
Start from scratch | Empty round — you add groups and employees manually |
Department | Auto-creates one group per department with employees pre-assigned |
Workplace | Auto-creates one group per workplace/location |
Manager | Auto-creates one group per manager's team |
Set the revision name, effective date (defaults to the 1st of next month), optional due date, and currency.
Click Create.
If you chose a template, groups are generated in the background. A loading indicator appears while groups are being created — this usually takes just a few seconds.
Setting up groups (Draft status)
While a revision is in Draft status, you can freely configure it:
Managing groups
Add a group: Click "+ New group" at the bottom of the groups table and type a name.
Delete a group: Click the three-dot menu on a group and select "Delete".
Merge groups: Click the three-dot menu on a group and select "Merge group..." to move all employees from that group into another. The source group is deleted after merging. Only available for groups in draft status.
Edit group details: Click into a group to change its name and rich text description.
Adding employees
Open a group and click "+ Add people".
An employee can only belong to one group per revision. If they're already in another group, you'll need to remove them first.
When an employee is added, a snapshot of their current job title, manager, department, location, and tenure is captured. This snapshot is what's displayed throughout the review — even if their role changes later.
Assigning reviewers and approvers
Open a group and use the + button next to "Reviewers" or "Approvers" to add people.
Every group must have at least one reviewer and one approver before you can start the revision.
A yellow banner reminds you: "Add approvers and reviewers to every group before starting a revision."
You can also add or remove reviewers and approvers after the revision has started, as long as the group is still in draft or in-review status. Newly added reviewers receive a notification.
Setting the approval mode
Click the settings icon next to "Approvers" in a group to choose:
Any approver — The first approver to approve or reject decides the outcome.
All approvers — Every approver must approve for the group to be approved. A single rejection rejects the group.
Starting the revision
When all groups have reviewers and approvers assigned:
Click "Start revision" (top-right button).
Confirm in the dialog. After starting, reviewers and approvers can no longer add or remove people — only superadmins can add or remove employees from groups that are still in review.
The revision moves to in review status. All groups move from Draft to in review.
All assigned reviewers receive a notification (via email, Slack, or Microsoft Teams) that they have been assigned to review a salary revision group.
Reviewing salaries (in review status)
For reviewers
Open your assigned group to see the employee table with these columns:
Column | Description |
Name | Employee name and avatar |
Job title | Role at the time they were added to the group |
Manager | Their manager at the time they were added |
Is manager | Whether the employee is a manager themselves |
Tenure | How long they've been with the company |
Previous increase | Their last salary increase as a percentage |
Current | Their current salary |
Pay period | Monthly, yearly, weekly, etc. |
Increase | Editable — enter the raise amount |
New | Auto-calculated: current salary + increase |
Compare | Salary converted to the revision's base currency for cross-currency comparison. Shows per month or per year depending on the display toggle. |
% Change | Editable — enter a percentage and the increase amount is calculated automatically |
Comment | Optional note about this employee's adjustment |
You can toggle columns on and off using the "Toggle columns" button, and switch between "Per month" and "Per year" display.
Tips:
You can enter either an increase amount or a % change — the other field updates automatically.
Use Tab to quickly move between employee rows.
Use the filter tabs (All, Reviewed, Pending review) to track progress.
Every employee must have a salary adjustment entered before you can submit.
Submitting for approval
Once all employees in the group have adjustments:
Click "Submit for approval".
Optionally add a comment explaining your reasoning.
The group moves to Pending Approval status.
All salary fields become read-only after submission.
Approving or rejecting (pending approval status)
For approvers
When a group is submitted for your approval, you'll see the proposed salary changes in read-only view plus Approve and Reject buttons.
Approve: Adds your approval. Depending on the approval mode:
Any approver: Your approval immediately approves the group.
All approvers: All approvers must approve before the group is approved.
Reject: Sends the group back to reviewers. Add a comment explaining what needs to change.
Each action is recorded in the comments timeline on the group page, showing who took what action and when.
If a group is rejected
The group status changes to Rejected, but salary fields become editable again for reviewers. Reviewers can:
Review the rejection feedback in the comments timeline.
Adjust salaries accordingly.
Re-submit for approval (the group moves back to Pending Approval).
Note: While salary amounts can be edited in rejected groups, employees cannot be added or removed — only groups in draft or in-review status allow that.
This cycle can repeat as many times as needed. The full history of submissions, rejections, and approvals is preserved in the comments timeline.
Applying salaries (final step)
Once all groups in a revision are approved:
The "Apply salaries..." button becomes active (top-right).
Click it to see a confirmation dialog showing:
Number of groups and employees affected
Effective date
Total annual increase (amount and percentage)
Click Confirm to apply.
The system processes salary updates in the background. A banner shows: "Applying salaries. This can take a few minutes for larger revisions."
On success, the revision moves to Completed status.
If something goes wrong, the revision moves to Failed status and you can retry.
New salary records are created for each employee with the effective date you set, and will appear in their salary history.
Status reference
Revision statuses
Status | Icon | Meaning |
Draft | Yellow dotted circle | Setting up — groups and people can be added/removed |
In review | Blue clock | Active — reviewers are entering salary adjustments |
Completed | Green checkmark | All salaries applied successfully |
Applying | Gray spinner | Salaries are being applied (background process) |
Failed | Red exclamation | Salary application failed — can be retried |
Group statuses
Status | Icon | Meaning |
Draft | Yellow dotted circle | Not yet started |
In review | Blue clock | Reviewer is working on salary adjustments |
Pending approval | Purple dot | Submitted, waiting for approver decision |
Approved | Green checkmark | Approved by approver(s) |
Rejected | Red X | Rejected — reviewer needs to revise and resubmit |
Notifications & reminders
Salary Revisions sends automatic notifications via email, Slack, and Microsoft Teams:
Event | Who receives it |
Revision started | All reviewers across all groups |
New reviewer added to an active group | The newly added reviewer |
Group approved or rejected | All reviewers in that group (except the approver who made the decision) |
Approaching due date (1 week before, 1 day before, on the day) | Reviewers of groups still in review |
Overdue | Reviewers of groups still in review |
Key concepts
Position snapshots
When an employee is added to a revision group, their current job title, manager, department, location, manager status, and tenure start date are captured as a snapshot. This ensures the review reflects the employee's situation at the time of the revision, even if their role changes during the process.
Multi-currency support
Each revision has a base currency set at creation. If employees have salaries in different currencies, the Compare column automatically converts their amounts to the revision's base currency using exchange rates. This lets reviewers make fair comparisons across different currencies and pay periods.
Pay period handling
The system supports multiple pay periods (monthly, yearly, weekly, bi-weekly, semi-monthly, hourly, daily) and handles conversions automatically when displaying comparisons.
Encrypted data
Salary amounts, employee comments, and group/revision descriptions are encrypted at rest for security.
FAQ
Can an employee be in multiple groups within the same revision? No. Each employee can only be in one group per revision round.
Can I edit a revision after starting it? Groups cannot be added, deleted, or merged after starting. Superadmins can still add or remove employees from groups that are in draft or in-review status. Reviewers can adjust salary amounts within their assigned groups.
What happens if I delete a revision? The revision and all its groups, employee assignments, and salary proposals are permanently deleted. Applied salaries are not affected.
Can a reviewer also be an approver for the same group? Technically yes, but it's recommended to separate these roles for proper oversight.
What if an employee doesn't have a current salary on file? The "% Change" field will be disabled for that employee. You can still enter an absolute salary amount. Note: when salaries are applied, employees without an existing salary on file are skipped — ensure salary records exist before starting the revision for the best results.
Can I change the effective date after salaries are applied? No. The effective date is set when creating the revision and locked when salaries are applied.
What does "Apply salaries" actually do? It creates a new salary record for each employee in the revision with the new amount, currency, pay period, and the revision's effective date. The new salary appears in the employee's salary history.
Can superadmins add or remove employees during the review phase? Yes. Superadmins can add or remove employees from groups that are in draft or in-review status. Groups that are pending approval, approved, or rejected do not allow employee changes.
Can I delete a revision in any status? Yes. Superadmins can delete a revision regardless of its current status. This permanently removes the revision and all associated data. Already-applied salary records are not affected.