Warnings is where HR records disciplinary cases: a verbal warning for late attendance, a written warning for an unauthorized absence, a final warning or an unpaid suspension for a safety breach. Each case gets a case number, follows a discipline ladder, can carry a payroll penalty, is acknowledged by the employee (who can also appeal once) and is finally closed with the outcome.
Use it whenever you need a dated, traceable record that an employee was formally warned, for example before a salary deduction, a suspension or ending employment.
HR staff (owners, SolaHR Administrators and HR managers) create, issue, correct and close warnings. Employees read, acknowledge and appeal their own warnings from My Portal or the employee portal. Line managers on an older staff role can see the warnings of the employees who report to them.
#Where to find it
| Screen | How to open it | URL |
|---|---|---|
| Warnings list | Sidebar People → Warnings | /warnings |
| One warning | View on a row | /warnings/{id} |
| Edit a warning | Edit on the warning page | /warnings/{id}/edit |
| Warning types (the ladder) | Warning types on the list | /warnings/types |
| From an employee | The disciplinary card on the employee's page (see Employees) | — |
| An employee's own warnings | My Portal → My Warnings | /self-service/warnings |
| Employee portal | Warnings in the employee portal menu | — |
You see the menu item only if:
- your organization's plan includes Warnings, and
- your role includes View warnings, documents, contracts (
hr.records.view).
If the plan doesn't include it, the page shows Not included in your plan. If your role doesn't allow it, you see Access denied.
#Who can do what
| Role | Sees | Can do |
|---|---|---|
| Owner, SolaHR Administrator | Every warning | Everything: types, create, edit, issue, penalties, appeals, delete drafts, resolve |
| Members on an older full HR manager role | Every warning | Everything |
| Members on an older general/staff role (View warnings, documents, contracts only) | Only their own warnings and those of employees whose Manager is them | View only |
| Scoped roles: HR Manager, Department Manager, Attendance Recorder, HR Viewer | Not this screen | Own warnings only, through My Portal |
| Employee (My Portal or employee portal) | Own issued, acknowledged, appealed and resolved warnings (never drafts) | Acknowledge, appeal once, download the attachment |
#The discipline ladder: warning types
Every workspace starts with a ready-made five-step ladder. The names, days and validity are editable starting points, not legal figures; change them to match your policy.
| Step | Type | Severity | Default consequence | Counts on the record for |
|---|---|---|---|---|
| 1 | Verbal warning | Low | Warning only | 6 months |
| 2 | First written warning | Medium | Warning only | 12 months |
| 3 | Second written warning | High | Salary deduction, 1 day | 12 months |
| 4 | Final warning | Critical | Salary deduction, 3 days | 12 months |
| 5 | Unpaid suspension | Critical | Unpaid suspension, 3 days | 12 months |
Open Warning types on the list to manage them. Each type has Name, Severity, Description, Step (position on the ladder; 0 = not part of it), Default consequence (Warning only, Salary deduction, Unpaid suspension or Paid suspension) with its days, and Counts for (months the warning stays on the record). Use Add a warning type for your own types, and Edit, Activate / Deactivate on a row.
Deleting one of the five built-in steps switches it off instead (you see Warning type switched off), because it would otherwise come back. A custom type that is already used by warnings cannot be deleted; deactivate it.
#The warnings list
Header: title Warnings; top-right Warning types and Issue a warning (users who can manage records).
Summary tiles:
| Tile | What it counts |
|---|---|
| Total warnings | All warnings you can see, with how many are from this month. |
| Pending acknowledgment | Issued warnings waiting for the employee to confirm receipt. |
| Critical warnings | Warnings of a critical type that are not yet resolved. |
| With payroll penalty | Warnings whose penalty is in payroll. |
When warnings are waiting for acknowledgement, a note above the table explains that they are already issued and in force: each employee confirms receipt in the portal, or HR records a signed paper copy from the warning page.
Filters: search by name or employee number, Status (Draft, Issued, Acknowledged, Appealed, Resolved) and Warning type.
Columns: case number (DISC-YYYYMMDD-NNNNN), employee, warning type and severity, warning date, Consequence (for example "Deduct 1 day(s) of salary" or "Unpaid suspension, 3 day(s)"), status, and View. An issued warning that is not yet acknowledged shows Awaiting employee acknowledgement — Penalty already applies when it carries a penalty.
#Create a warning
- Click Issue a warning. The form is laid out in two columns.
- Employee: choose an active employee. The form shows their record: No warnings in force for this employee, or the number in force and Suggested next step: … from the ladder. When the employee is already at the top step you see a hint to consider a suspension or ending the employment.
- Warning details: Warning type, Warning date (the date of the violation), Description of the violation, and Counts on the record until (defaults to the type's validity after the warning date; change it only if your policy says otherwise).
- Consequence & payroll: starts from the type's default and can be changed:
- Warning only: no payroll deduction.
- Salary deduction: Deduct by Days of salary (days × monthly salary ÷ the working days per month in Payroll Settings, 30 if not set) or Fixed amount. An Estimated amount is shown.
- Unpaid suspension: Suspension from / Suspension to (at most 30 days). The suspended days are deducted.
- Paid suspension: attendance is excused for those dates and the salary is kept; no deduction is created.
- Notes and evidence: Action taken (notes for the file) and an optional Attachment (signed letter, photo or evidence; PDF, image or Word, up to 10 MB).
- Delivery and acknowledgement — "How is it handed to the employee?":
- Issue now: the employee sees it in the portal and acknowledges there.
- Signed on paper: the employee already signed a printed copy; enter the date they signed.
- Save as draft: nothing is sent and nothing reaches payroll until you issue it.
- Click Issue warning, Issue and record signature or Save as draft. When a penalty is set, the issue confirmation says what will be added to payroll.
#How a penalty reaches payroll
When the warning is issued, its penalty becomes a penalty deduction in that month's payroll, linked to the warning. If that month is already closed, it goes into the next open payroll. The warning page shows In payroll for {month} or Deducted in the closed payroll of {month}.
You can also link a deduction to a warning from Payroll & Compensation → Deductions: pick Linked warning (optional) and the deduction becomes that warning's penalty. Deductions created, edited or deleted there show on the warning's history. See Deductions.
#The warning page
- Header: case number, employee, status badge. A draft says "This warning is a draft — the employee cannot see it yet." and what will happen when issued.
- Employee information and Warning details: type and severity, warning date, issued by, acknowledged at (or Not yet), counts on the record until, escalated from (when issued as the next step), other warnings in force, and Download attachment.
- Consequence & payroll: the penalty, estimated amount and payroll status.
- Discipline ladder: where this warning sits on the employee's ladder.
- Appeal: when there is one, the reason, decision and who decided.
- What happened: a timeline of every step: created, issued, corrected, acknowledged, penalty added / changed / cancelled / refunded, appeal submitted and decided, case closed, and changes made on the Deductions page.
- Next steps (users who can manage records):
| Action | When | What it does |
|---|---|---|
| Edit | Any open warning | Change any detail, the consequence or the attachment. After issue, the employee can't change it, the penalty is changed with Apply / Cancel penalty, and each edit is recorded as Corrected in the audit log. |
| Issue | Draft | Sends it to the employee and applies its consequence. |
| Issue next warning (Escalate) | Issued or acknowledged | Opens a new warning at the next ladder step. |
| Apply penalty / Cancel penalty | Open warning | Adds a salary deduction or suspension, or removes it while the payroll month is still open. |
| Record signed acknowledgement | Issued | The employee signed a paper copy instead of acknowledging in the portal. |
| Record an appeal | Issued or acknowledged, not yet appealed | The employee disagreed in person or in writing. |
| Uphold warning / Withdraw warning | Appealed | Decide the appeal. |
| Start end of service | Issued or acknowledged | Opens a termination with this employee pre-selected, see End of Service. |
| Resolve disciplinary action | Issued or acknowledged | Record the Final action and Close case. |
| Delete | Draft | Drafts can be deleted; issued warnings stay on the record. |
#Employee acknowledgement
An issued warning already counts on the record and its penalty already applies. Acknowledgement only confirms the employee received it; it holds nothing back.
The employee opens Warnings in the employee portal (or My Portal → My Warnings), reads the warning, optionally types a response and clicks Acknowledge. If they signed a printed copy instead, HR uses Record signed acknowledgement on the warning page; the portal then shows it as acknowledged.
#Appeals
An employee can appeal a warning once, while it is issued or acknowledged and not closed. In the portal they open the warning, choose Appeal this warning, explain why and click Send appeal. HR is notified and the appeal also appears in Approvals. HR can also Record an appeal received on paper.
HR then decides, with Decision notes that the employee sees:
- Uphold warning: the warning returns to its previous status and keeps any penalty.
- Withdraw warning: the case closes and the warning stops counting on the record. Its penalty is removed from payroll, or refunded in the next open payroll if it was already paid.
The employee sees "Your appeal is under review", then whether the warning stands or was withdrawn, with HR's notes.
#Suspensions
An Unpaid suspension stops the employee from working for those dates:
- The employee profile shows Suspension scheduled or Suspended from work, with the period, days, case and the payroll deduction. If the employee has no salary set, the suspension deducts 0 and the profile says so.
- Attendance cannot be recorded for the employee during the suspension, by HR or by check-in links.
- The daily attendance roster marks the employee "Unpaid suspension until {date} ({case}) — should not be working", see Attendance.
A Paid suspension excuses attendance for the dates and keeps the salary.
#Statuses and lifecycle
| Status | How it gets there | Employee sees it |
|---|---|---|
| Draft | Save as draft | No |
| Issued | Issue now, or Issue on a draft; the penalty goes to payroll | Yes |
| Acknowledged | The employee acknowledges, or HR records a signed copy | Yes, with their response |
| Appealed | The employee appeals, or HR records an appeal | Yes, "under review" |
| Resolved | Close case, or the appeal is withdrawn | Yes |
#Worked example: {User 2 name}'s lateness
- {User 2 name} is late three times. HR clicks Issue a warning, picks {User 2 name}: "No warnings in force for this employee". Suggested next step is the verbal warning. HR leaves Issue now and clicks Issue warning.
- Two months later {User 2 name} is late again. The form shows "1 warning(s) in force" and suggests First written warning. HR issues it.
- A third time: the suggestion is Second written warning, with Deduct 1 day(s) of salary. With a salary of AED 6,000 and 30 working days per month, the estimate is AED 200. The confirmation says it will be added to payroll; the warning page shows In payroll for 2026-11.
- {User 2 name} appeals in the portal ("The metro was closed that day"). HR checks, clicks Withdraw warning with a note. The deduction is removed from the open November payroll and the warning stops counting.
#How it connects
| Screen / app | Connection |
|---|---|
| Employees | The profile shows warnings on record, those with a penalty, and any suspension. |
| Deductions / Payroll | Penalties are linked penalty deductions in the month's payroll; don't add a manual deduction for the same penalty. |
| Attendance | Unpaid suspensions block attendance and show on the roster. |
| Approvals | Appeals waiting for a decision. |
| End of Service | Start end of service from a warning. |
| Audit log | Every step and correction is recorded. |
#Tips and common problems
| Problem | Cause | Fix |
|---|---|---|
| The penalty went to next month's payroll. | The month of the warning was already closed. | Expected; the line is labelled as the warning's penalty. |
| Cancel penalty is not available. | The payroll month is closed. | Withdraw on appeal (refunds in the next open payroll), or add a correcting earning. |
| The suspension deducts 0. | No salary on the employee record. | Set the salary, then re-apply the penalty. |
| Attendance for a suspended employee is refused. | Unpaid suspension in force. | Expected. Shorten the suspension on the warning if it was wrong. |
| The employee can't appeal. | They already appealed, or the case is closed. | One appeal per warning. |
| A built-in type disappeared after delete. | Built-in steps are switched off, not deleted. | Activate it again from Warning types. |