Skip to main content
Version: Latest
User ManualNeed configuration, code or deployment details? In the Technical Manual: Workforce

Time Off

Time Off keeps track of the time workers may take and the time they ask for. You set up types of time off, such as vacation or sick time, and policies that say how workers earn each type and who they apply to. Each worker has a balance under each policy, kept as a ledger of every change. A request is checked against the balance, the worker's other time off and blackout dates; an allotment says how many people of a team may be off on a day, approves the requests that fit, and puts the rest on a waitlist. Approved time off goes on the team's Workforce calendar.

MenuWorkforce > Time Management > Time-Off Requests, Time-Off Types, Time-Off Policies, Time-Off Allotments, Blackout Dates
PermissionApprove time off, Adjust time-off balances, Manage time-off policies, Manage the whole workforce
FeatureWorkforce Time Off (it needs Workforce)
Can't find it?

What you see depends on your role. If the menu, a button or a setting on this page is missing, ask your administrator to give you the permission listed above or to turn on the feature. Only administrators can turn features on and change site settings.

A manager sees and decides the time off of the teams they manage, as described in Workers and Teams. Types, policies, allotments and blackout dates are set up by someone with Manage time-off policies.

Time-off types​

Open Workforce > Time Management > Time-Off Types and choose Add time-off type.

FieldWhat it does
NameThe type's name, such as Vacation, Sick or Jury duty.
DescriptionShown when a type is chosen.
Counted inHours or days.
Hours in a dayWhat a weekday counts when the worker has no shift that day.
ColorHow the time off is drawn on the calendar.
Pay codeThe code payroll pays it under, if any.
PaidWhether the time off is paid.
Needs a balanceA request is refused when the worker's policy for this type doesn't have enough.
Part of a day can be requestedAllows some hours of one day.
Needs a reasonA request must say why.
Takes a place in allotmentsTurn off for time off that is never limited, such as jury duty.
Workers can request itTurn off for a type only managers record.

What a day counts​

A day on which the worker has published shifts counts the paid time of those shifts, so an 8-hour shift with an unpaid half-hour meal counts 7.5 hours. A weekday with no shift counts the type's Hours in a day. Saturday and Sunday with no shift count nothing. For a type counted in days, each day counts one day, and part of a day counts its share of Hours in a day.

Time-off policies​

A policy says how workers earn one type of time off and keep it. Open Workforce > Time Management > Time-Off Policies and choose Add time-off policy.

FieldWhat it does
Time-off typeThe type the policy is for.
Workers earnNothing (balances change only by hand), a set amount each period, an amount for each hour worked, or the year's amount at the reset date.
AmountPer period, per hour worked or per year, in the type's unit.
PeriodWeekly, every two weeks, twice a month (the 1st to the 15th and the 16th to the end) or monthly. A weekly or two-week period starts on the date you give, or on a Monday.
Rates by serviceHigher amounts after months of service, one per line, such as 12 = 10. Service counts from the worker's seniority date, or else their hire date.
Waiting periodHow many days after the hire date accrual begins.
Most the balance can reachAccrual stops while the balance is at this amount.
Reset dateThe start of the policy's year. The yearly amount is given then, and what is above the carryover limit expires.
Most that carries overWhat is kept at the reset date. Leave it empty to keep everything.
Can go below zero byHow much a worker may borrow against what they will earn.
TeamsThe teams the policy applies to, with the teams under them, from and to the dates you give.

Each period is earned when it ends. Hours worked are the paid time of the worker's published shifts in the period. A worker who becomes eligible during the year gets the share of the yearly amount left in that year.

A worker on several teams gets, for each type, the policy of the nearest team: their own team before the teams above it. A policy assigned to the worker alone, on their Time off page, comes first.

Accrual runs every hour and adds what each policy owes for the periods that have ended. Each period is added once, however often accrual runs.

Balances​

In Workforce > Workers, open a worker's Actions menu and choose Time off. The page shows, for each policy that applies to them today:

ColumnWhat it means
BalanceThe sum of the ledger up to today.
Approved, to comeApproved time off that hasn't started yet.
WaitingRequests that wait for a place or a decision.
AvailableWhat can still be requested: the balance less the two columns before it.

The Ledger lists every change, newest first: opening balances, what was earned, taken, given back, carried over, expired or paid out, and corrections, with who made each change.

With Adjust time-off balances, Change a balance adds an opening balance (such as one brought from another system), a correction, a carryover, a grant or a payout. A negative correction takes away; a payout always takes away.

A grant with a last day gives hours or days to use by a date, such as 40 hours of year-end bonus time to use by 30 December. Time off taken comes out of grants first, the one that ends soonest first, and only then out of the rest of the balance, oldest first. Canceled time off goes back to the grant. The balance shows what is left of each grant and its last day, and so does the worker's Time off page in My Work. The day after the last day, what is left of the grant expires, and a request for a later day can't count on it. With Manage time-off policies, Policies of their own gives the worker a policy from and to a date, which replaces their teams' policy of that type.

Time off in Time Tracker​

With Time Tracker on, every day of approved time off of a worker with a login is kept there once the day comes, in the stage of its type, so the hours report counts it with worked time. Each type gets a stage named after it when Time Tracker is turned on, counting toward Time off, and toward Paid when the type is paid. Choose another stage under Time Tracker on the type. A full day starts at 9:00 in the worker's time; a part day ends at its end. Canceled time off is taken out. These entries are read-only in Time Tracker: change the time off instead.

Requesting time off​

Open Workforce > Time Management > Time-Off Requests and choose Request time off to record a request for a worker of a team you manage.

FieldWhat it does
WorkerWho the time off is for.
TypeThe type of time off.
DaysThe first and the last day.
Only part of the first dayAsks for some hours of one day.
ReasonSeen by the managers who decide. Some types need one.

Choose Check first to see what each day counts, the balance on the first day and after the request, how many published shifts it overlaps, the days on which the allotment is full, and what submitting would do. Choose Submit to make the request. It is refused when:

  • a day falls in blackout dates of the worker's team;
  • the type needs a balance and the worker doesn't have enough on the first day (see Balances);
  • the worker already has time off or a request on one of the days;
  • the type needs a reason and none is given;
  • the days count nothing, because they fall on a weekend and the worker has no shifts then.

A request that is accepted is approved at once when it fits an allotment that approves on its own, put on the waitlist when the allotment is full, and otherwise waits for a manager.

Deciding on requests​

Workforce > Time Management > Time-Off Requests lists the requests that wait for a place or a decision, from the teams you manage, earliest first. Filter by team or status to see approved, declined, canceled or withdrawn requests. Tick requests and use the bulk actions to Approve or Decline several at once.

Choose View to open a request. It shows each day and what it counts, the worker's balance on the first day, the worker's published shifts on those days, and who else on the team is off or has asked to be off then. Add an optional note to the worker and choose:

ButtonWhat it does
ApprovePuts the time off on the team's Workforce calendar and takes it from the balance. A manager can approve a request even when the allotment is full.
DeclineTurns the request down.
WithdrawTakes back a request that hasn't been decided.
Cancel the time offFor approved time off: gives the balance back, takes it off the calendar, and gives the place to the first request waiting for it.

Shifts under approved time off​

When approved time off overlaps a worker's published shifts, the team's Shifts under approved time off setting decides what happens (see Team settings):

  • Keep them, flagged for cover (the default): the shifts stay, and the request and the queue show how many need cover.
  • Take them off the schedule: the shifts are removed from the calendar and the schedule, so the next publish doesn't put them back, and the change log shows Removed as the worker's request.

When the time off is canceled, the removed shifts that are still to come are put back on the schedule, with their drafts, and the change log shows them Added, unless the worker has been given another shift at that time since.

On the calendar​

Approved time off is an event on the team's Workforce calendar that can't be edited there. Requests that wait for a place or a decision show on the same calendar as Requested or Waitlisted events, which don't make the worker busy.

Allotments​

An allotment says how many people of a team, and the teams under it, may be off on a day. Open Workforce > Time Management > Time-Off Allotments and choose Add allotment.

FieldWhat it does
TeamThe team the allotment covers, with the teams under it.
People who may be offA number for each day of the week.
Other numbers on datesOne per line, a date and a number, such as 2026-12-24 = 1, for a holiday or a busy day.
Time-off typesThe types it counts. Leave it empty for every type that takes a place in allotments.
Approve requests that fit with no managerA request on days with a place left is approved as soon as it is made.
When it's fullPut the request on the waitlist, or send it to a manager.

Approved and pending requests each take a place on every day they count something; waitlisted ones don't. When two requests arrive at once for the last place, one gets it and the other is waitlisted.

When time off is canceled or a pending request is withdrawn, the waitlisted requests for those days are looked at in the order they were made. Each one that now fits every allotment it falls under is approved, or sent to a manager when an allotment doesn't approve on its own.

Blackout dates​

Open Workforce > Time Management > Blackout Dates and choose Add blackout dates to block time off on dates such as a busy season.

FieldWhat it does
DaysThe first and the last day.
TeamThe team, with the teams under it. Leave Every team to block them for everyone.
Time-off typesThe types it blocks. Leave it empty to block every type.
MessageWhat is shown when a request falls on these dates.

Permissions​

PermissionAllows
Approve time offThe time-off queue, requesting time off for a worker, deciding and canceling, and a worker's balances, for the teams you manage.
Adjust time-off balancesChanging the balances of the workers of the teams you manage.
Manage time-off policiesTypes, policies, allotments and blackout dates, and giving a worker a policy of their own.
Request time offRequesting one's own time off, in the My Work portal.