# Pay Run Dashboard

<p class="doc-lead">The Pay Run Dashboard is the Payroll landing page. It shows approved pay-run totals for a selected period, a pending-documents queue, net payroll over time, and net by department.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/payroll/pay-run-dashboard?id=overview">Overview</a>
<a href="#/payroll/pay-run-dashboard?id=period-filter">Period filter</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Widgets &amp; charts</span>
<div class="doc-toc-links">
<a href="#/payroll/pay-run-dashboard?id=financial">Financial KPIs</a>
<a href="#/payroll/pay-run-dashboard?id=pending">Pending</a>
<a href="#/payroll/pay-run-dashboard?id=charts">Charts</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/payroll/pay-run-dashboard?id=example">Example</a>
<a href="#/payroll/pay-run-dashboard?id=faq">FAQ</a>
<a href="#/payroll/pay-run-dashboard?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview</h2>

Go to <b>Payroll → Dashboard</b> from the left menu. Opening Payroll lands on this page when your role has dashboard access.

> Screenshot pending — `payroll/images/pay-run-dashboard.webp`

<b>Who sees what</b>

| **Section** | **Typical access** |
|-------------|-------------------|
| Financial KPIs, Pending, charts | Users with Payroll Dashboard widget permission |
| Drill-down from finance cards | Users who can open <a href="#/payroll/reports/employee-wise-payrun-report">Employee Wise Pay Run</a> |
| Net by department title | Users who can open <a href="#/payroll/reports/department-wise-salary-report">Department Wise Salary</a> |

<hr class="doc-section-divider">

<h2 id="period-filter">Period filter</h2>

Each charted section has its own period dropdown. There is no page-level date picker.

| **Section** | **Options** | **Default** |
|-------------|-------------|-------------|
| Financial KPIs | This month, Last month, Last 3 months, This / Last financial year, This / Last year | This month |
| Net payroll chart | Last months, This / Last month, This / Last financial year, This / Last year | Last months (12 months) |
| Net by department | Same as Financial KPIs | This month |
| Pending | None — open backlog, not limited by the finance period | — |

The date range next to the finance dropdown is the from/to used for those cards (for example <b>01 Aug 2026 – 31 Aug 2026</b>).

<hr class="doc-section-divider">

<h2 id="financial">Financial KPIs</h2>

Totals come from <b>Approved</b> and <b>Closed</b> pay runs whose pay period (<b>From</b> / <b>To</b>) overlaps the selected range — the same overlap rule as <a href="#/payroll/reports/employee-wise-payrun-report">Employee Wise Pay Run</a>. Draft and cancelled pay runs are excluded.

| **Widget** | **What it shows** | **Click action** |
|------------|-------------------|------------------|
| <b>Gross</b> | Sum of pay-run <b>payment totals</b> (earnings / salary payables) | Employee Wise Pay Run for the same dates |
| <b>Deductions</b> | Sum of pay-run deduction totals | Same report |
| <b>Expenses</b> | Sum of pay-run expense / reimbursement totals | Same report |
| <b>Net payroll</b> | Sum of pay-run net totals (payments − deductions + expenses) | Same report |
| <b>Unpaid balance</b> | Sum of pay-run balances still owed | Same report with <b>Balance Only</b> on |
| <b>Employees paid</b> | Distinct employees with an approved/closed pay run in the period | Same report |

<b>Percentage on finance cards</b>

Gross, Deductions, Expenses, Net payroll, and Unpaid balance show change vs the <b>previous period of the same length</b>:

<code>(this period − previous period) / |previous period| × 100</code>

Examples: This month vs last month; Last 3 months vs the 3 months before that; This financial year vs last financial year.

The percentage is hidden when the previous total is <b>0</b> (so Expenses with no prior amount shows no %). Employees paid does not show a percentage.

<hr class="doc-section-divider">

<h2 id="pending">Pending</h2>

Open items that still need payroll action. This section is <b>not</b> filtered by the finance period. Click a card to open the matching list with status <b>Approved</b> (the Approved tab).

| **Widget** | **What it shows** | **Click action** |
|------------|-------------------|------------------|
| Pending Expense Claims | Approved claims not yet settled on a pay run | <a href="#/payroll/expense-claim">Expense Claim</a> list, status Approved |
| Pending Advance Vouchers | Approved/closed cash advance vouchers with balance &gt; 0 | <a href="#/payroll/cash-advance-voucher">Cash Advance Voucher</a> list, status Approved |
| Pending Production Wages | Approved production wages not yet on a pay run | <a href="#/payroll/production-wage">Production Wage</a> list, status Approved |
| Pending Overtime | Approved overtime entries not yet on a pay run | <a href="#/payroll/overtime-entry">Overtime Entry</a> list, status Approved |
| Pending Advance Requests | Draft / unapproved cash advance requests | <a href="#/payroll/cash-advance-request">Cash Advance Request</a> list, status Approved |

Cards with a count turn amber so they stand out from empty (navy) cards. You need list access for that transaction to open the drill-down.

<hr class="doc-section-divider">

<h2 id="charts">Charts</h2>

<h3 id="net-payroll">Net payroll</h3>

Line chart of net pay-run totals over the chart period (by month, or by day for This / Last month). Use the dropdown to switch range.

<h3 id="net-by-department">Net by department</h3>

Bar chart of net payroll by employee department for the selected period. Departments with zero net are omitted. Click the <b>Net by department</b> title to open <a href="#/payroll/reports/department-wise-salary-report">Department Wise Salary</a> for the same dates.

<hr class="doc-section-divider">

<h2 id="example">Example</h2>

A payroll accountant opens Payroll at month end. Financial cards default to this month. They switch to <b>Last month</b> to confirm last cycle’s Gross and Net, then click <b>Unpaid balance</b> to open Employee Wise Pay Run with Balance Only and create payment vouchers.

They scan Pending for leftover overtime and expense claims (click a card to open that list, status Approved) before starting the new pay run, then use Net by department to see which teams drove net pay.

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>Why did Gross not change when I picked This financial year?</b><br>
The finance dropdown must update the date range next to it. Totals only include Approved and Closed pay runs whose <b>From / To</b> overlap that range — not process date alone. This month, this year, and this financial year can look the same if all of those pay runs fall in the current month.

<b>Is Gross the same as net pay?</b><br>
No. Gross is the sum of <b>payment (earnings) lines</b>. Deductions and expenses are separate cards. Net payroll is payments − deductions + expenses.

<b>What does the percentage mean?</b><br>
Change vs the previous period of the same length, not a share of Gross. Hidden when the previous amount is zero.

<b>Why is Unpaid balance equal to Net payroll?</b><br>
No Payment Out has been applied to those pay runs yet, so the full net is still outstanding.

<b>Does Pending use the same dates as Gross?</b><br>
No. Pending is the current open queue (claims, advances, OT, production wages), not limited to the finance period.

<b>What happens when I click a pending card?</b><br>
The matching document list opens with status <b>Approved</b>. Expense claims, production wages, and overtime match the card (those KPIs are approved docs). Advance vouchers on the card also include closed docs with remaining balance — the list is Approved only. Advance requests on the card are drafts; the click still opens the Approved list.

<b>Why do I not see the dashboard?</b><br>
Your role needs the Payroll Dashboard widget. Finance card clicks also need <a href="#/payroll/reports/employee-wise-payrun-report">Employee Wise Pay Run</a> report access.

<b>How is this different from the Pay Run list?</b><br>
The list is every pay-run document. The dashboard is totals, pending work, and trends. Click a finance card to open the report, not the list.

<hr class="doc-section-divider">

<h2 id="related">Related</h2>

<ul>
<li><a href="#/payroll/pay-run">Pay Run</a></li>
<li><a href="#/payroll/reports/employee-wise-payrun-report">Employee Wise Pay Run</a></li>
<li><a href="#/payroll/reports/department-wise-salary-report">Department Wise Salary</a></li>
<li><a href="#/payroll/expense-claim">Expense Claim</a></li>
<li><a href="#/payroll/cash-advance-voucher">Cash Advance Voucher</a></li>
<li><a href="#/payroll/cash-advance-request">Cash Advance Request</a></li>
<li><a href="#/payroll/overtime-entry">Overtime Entry</a></li>
<li><a href="#/payroll/production-wage">Production Wage</a></li>
</ul>
