UKG Accrual Policy Setup and Testing: A Practical Guide
Setting up UKG accrual policies well means translating each leave policy into grants, limits, carryover and probation rules, loading accurate starting balances, and testing every policy against hire dates, anniversaries and year end before employees see a balance. Most accrual complaints trace back to an untested edge case, not to the software.
Key takeaways
- In UKG Pro Workforce Management, accrual policies hold the codes, grants and takings, and accrual profiles assign those policies to employees.
- Write every policy as numbers first: earning rate, cap, carryover, waiting period, payout. Ambiguous handbooks produce ambiguous balances.
- Opening balances from the legacy system are the riskiest part of an accrual migration. Reconcile them employee by employee.
- Federal law does not require paid vacation, but state and local paid sick leave laws often dictate accrual rates and carryover.
- Test with a synthetic cast of employees and run them across a full plan year before go-live.
How are UKG accruals structured?
UKG's Accruals setup reference for UKG Pro Workforce Management lists the components you will work with. Confirm names and options in your own tenant, because releases and licensing change what you see.
| Component | Role in the design |
|---|---|
| Accrual codes | Identify each balance, such as vacation, sick or floating holiday |
| Accrual policies | Contain codes, grants and takings, and control how and when balances are credited or debited |
| Accrual profiles | Group policies and assign them to employees |
| Accrual grants | Credit balances on a fixed schedule or based on earning paycodes (for example, per hour worked) |
| Accrual limits | Taking, earning and carryover limits that cap balances and control what moves to the next interval |
| Probation periods | Restrict when accrued time or money can be used |
| Balance cascades | Automate payouts and transfers between balances |
| Date patterns and accrual dates | Define when balances increase and which dates govern accruals |
UKG Ready uses its own accrual configuration. UKG describes the UKG Ready Accruals Manager as calculating accruals based on factors such as hours worked, tenure, pay level and attendance. The concepts below apply to both products, but the setup screens and terms differ, so map them with your administrator or partner.
How do you turn a leave policy into accrual rules?
Handbooks are written for people. Accrual engines need numbers. Before configuration, convert each policy into a one page spec that answers these questions.
The accrual spec
- Who: Which employees, by FLSA status, location, union, employment type and standard hours.
- How it is earned: Per hour worked, per pay period, monthly, or a lump sum grant on a date.
- Which hours count: Does overtime earn accruals? Does PTO taken earn accruals? Each earning paycode needs a yes or no.
- Tenure tiers: The service date that drives tiers and the exact day a new tier starts.
- Caps: Maximum balance, and what happens at the cap (earning stops, or earning continues and is forfeited).
- Carryover: How much moves to the next year and on what date.
- Waiting period: Whether time accrues but cannot be used for a period after hire.
- Negative balances: Allowed or not, and by how much.
- Payout: At termination, at year end, or never, subject to state law.
A realistic example: a handbook says "full time staff earn three weeks of vacation after one year." The spec must say whether that means 120 hours or 15 days, whether part time staff earn a prorated amount, whether the first year is earned per pay period or granted on the anniversary, and whether the year is a calendar year or an anniversary year. Each answer is a different configuration.
If you are reconsidering the policy itself, our piece on what unlimited PTO actually costs employers covers the alternatives.
What does the law require for PTO and sick leave accruals?
The Department of Labor's vacation leave page states that the FLSA "does not require payment for time not worked, such as vacations, sick leave or federal or other holidays." Vacation is a matter of agreement between employer and employee, with exceptions for certain federal contracts.
That federal baseline is where the simplicity ends. Many states and cities have paid sick leave laws that set a minimum earning rate, annual usage and carryover rules, and some states treat earned vacation as wages that must be paid out at separation. If you operate in several states, expect one accrual policy per legal regime, not one for the whole company. Have employment counsel review the spec before configuration, and record the legal citation for each rule in the spec so future administrators know why it exists.
Accrual design also touches overtime. Paid leave is excluded from the FLSA regular rate, and whether leave hours count toward the 40 hour threshold is an employer choice unless a contract or state rule says otherwise. See whether PTO counts toward weekly overtime for the detail.
How should you migrate opening balances?
Most accrual escalations after go-live are about balances that changed overnight. A careful migration avoids them.
- Pick a cutover date that aligns with a pay period end, so the legacy system's last accrual run is complete.
- Extract balances by code and employee, along with the service dates and tier the legacy system used.
- Recalculate a sample independently. Pick employees near tier changes, caps and carryover limits and confirm their legacy balances are actually correct.
- Load and compare. After loading, run a balance report in UKG and compare to the extract for every employee, not a sample.
- Freeze and communicate. Tell employees the date balances will move and where to see them, and give managers a path to report discrepancies.
Watch pending requests. Time off approved in the old system for dates after cutover must either be re-entered in UKG or deducted from the opening balance, but never both.
How do you test UKG accrual policies?
Create a cast of test employees whose dates and hours are designed to hit every rule, then project or run them across a full plan year in a non production tenant.
| Test employee | Designed to prove |
|---|---|
| New hire mid pay period | Proration and the probation or waiting period |
| Employee one week before anniversary | Tier change on the correct date |
| Employee at the cap | Earning stops or forfeits as the policy says |
| Employee with large balance at year end | Carryover limit and any cascade or payout |
| Part time employee with variable hours | Per hour earning and which paycodes earn |
| Employee with heavy overtime | Whether overtime hours earn accruals |
| Employee who transfers to another state | Profile change and balance handling |
| Rehire within the reinstatement window | Any reinstatement rule your state requires |
| Termination | Payout calculation passed to payroll |
Also test the request experience. Submit time off requests that exceed the available balance, requests during the probation period, and requests that span year end, and confirm the validation messages make sense to an employee. Our article on mandating PTO usage during unexpected closures shows why bulk adjustments also belong in the test plan.
For more UKG administration content, browse our UKG guides hub.
Frequently Asked Questions
What is the difference between an accrual policy and an accrual profile in UKG?
In UKG Pro Workforce Management, an accrual policy contains the accrual codes, grants, takings and limits that define how a balance behaves. An accrual profile groups one or more policies and is what you assign to employees. Keeping policies small and reusable makes profiles easier to maintain when you add locations or employee groups.
Should accruals be earned per hour worked or granted up front?
Per hour earning suits variable schedules and some state sick leave laws, because the balance tracks actual work. Up front grants are simpler for salaried staff and easier for employees to understand, but can create negative balances or recovery questions when someone leaves early. Choose by population, and confirm the method meets any applicable state minimums.
How do we fix a wrong accrual balance after go-live?
First find the cause: wrong opening balance, wrong rule, or wrong employee data such as a service date. Fix the cause before adjusting the balance, or the error will recur. Document every manual adjustment with a reason and approver, since adjustments are what auditors and employees question most.
Do we need separate accrual policies for each state?
Often, yes. Paid sick leave laws differ by state and city on earning rates, caps, carryover and use. A single companywide policy can work only if it meets or exceeds every applicable requirement. Many employers keep one vacation policy and separate sick leave policies by jurisdiction.
Practical next steps
- Write a one page accrual spec for every leave type and population, reviewed by counsel.
- Map each spec to UKG components and flag anything that needs a non standard approach.
- Build the test cast and run it across a full plan year in a non production tenant.
- Reconcile 100 percent of opening balances before cutover.
- Publish a short employee guide explaining how balances are earned and where to see them.
Last reviewed: October 2026.
Sources
- Accruals setup reference, UKG Pro Workforce Management Help
- UKG Ready Accruals Manager, UKG
- Vacation Leave, U.S. Department of Labor
Comments
Post a Comment