Attendance rules and setup
Tell Agoo how your organisation works, from the working day, breaks and overtime to the leave year and timesheet approval, starting from Ghana's defaults.
Agoo is in early access. This page describes the feature as it ships to early-access organisations; screens are illustrative.
Your attendance rules say how your organisation works: which days and hours make a normal day, what kind of break it has, when overtime starts, when your leave year starts, and how timesheets are approved. Agoo asks for them when you start, keeps a checklist on Home until each one is confirmed, and keeps every earlier version, so a change never rewrites months already worked. The rules are on every plan, in Console → Attendance → Settings.
Nothing changes until you change it
Until you save your own rules, Agoo uses Ghana's defaults below, which count time exactly as Agoo always has: a paid 30-minute break, with nothing taken off. Breaks, overtime, leave and timesheets use your rules now; lateness uses them with shifts.
Setting up staff time
When you set up your organisation, the setup wizard asks Will you keep staff time in Agoo? after your first site. Only Owners and Admins see it.
- Yes opens one screen with six things, each filled in with Ghana's defaults: your working week and day, the kind of day, when overtime starts (after your standard day, at least 8 hours, and 40 hours a week) and whether it needs approval, your leave year, annual leave and what happens to annual leave nobody took, who approves leave, and the timesheet period, who approves timesheets, whether staff confirm their own and your payroll day. It also asks Do you roster shifts? and, on Growth and above, how swaps and open shifts work. Change what's different and save.
- Not now skips it. Home asks again later.
- We don't keep staff time tells Agoo you don't use attendance, and Home stops asking. You can still set the rules whenever you like.
The checklist on Home
Until every setting is confirmed, Home shows Set up staff time to people who manage attendance for the whole organisation or its settings. Each line opens the setting, and you confirm it by saving or by choosing Looks right. Agoo records who confirmed it and when.
| Item | What it asks | Plans |
|---|---|---|
| Working week and standard day | Your work days and the hours of a normal day | Every plan |
| Breaks | One stretch with a paid break, or a day in two parts | Every plan |
| Lateness grace and absence alerts | How late counts as late, and who is told | Growth and above |
| Overtime | When hours count as overtime, and whether it needs approval | Every plan |
| Leave types, allowances and carry-over | When your leave year starts, the annual days, and what happens to unused annual leave | Every plan |
| Who approves leave | The line manager, the line manager then HR, HR only, or no approval | Every plan |
| Public holidays | Whether Ghana's public holidays apply to you | Every plan |
| Timesheet period and approval | How often timesheets close, who approves them and who can reopen | Every plan |
| Line managers | "12 people on attendance have no manager" | Every plan |
| Start dates | People on attendance with no start date, needed for first-year leave | Every plan |
| Your first roster | Whether you roster shifts, ticked when you publish your first roster | Growth and above |
| Swaps and open shifts | Whether staff swap shifts and claim open shifts, and who approves them | Growth and above |
| Pay codes and the export layout | Your code and multiplier for each kind of time and leave in payroll files, and your own file layout | Pro and above |
| Employee numbers | People on attendance with no employee number, needed for payroll files | Pro and above |
Line managers, Start dates and Employee numbers tick themselves once nobody is missing, or when you choose Looks right. Your first roster ticks itself when you publish a roster at any site, or when you answer No to Do you roster shifts?, which the setup wizard's Staff time step asks too. See Rosters. Swaps and open shifts ticks itself when you save the roster's swaps and open shifts settings or choose Looks right; the wizard's Staff time step asks it too. Items your plan doesn't include show which plan adds them and don't count. Pay codes and the export layout ticks itself when you save the pay codes or a layout on Attendance → Payroll, or choose Looks right; like leave and timesheets, it's for HR, Owners and Admins. See Pay codes. The card goes once everything is confirmed, and comes back if an upgrade adds an item.
Each confirmation is recorded in the audit trail as Confirmed attendance settings, and your answer to the wizard's question as Answered whether to keep staff time in Agoo.
The rules
Open Console → Attendance → Settings. Each section says what it's for, shows Ghana's default, and has Looks right if it's already right for you.
Working time
| Setting | What it's for | Ghana's default |
|---|---|---|
| Work days | The days of your normal week. Leave counts working days from it. | Monday to Friday |
| The day starts, ends | The standard day, for people without shifts | 08:00 to 17:00 |
Breaks
The Labour Act has two kinds of working day, and the kind decides whether the break is paid.
| Setting | What it's for | Ghana's default |
|---|---|---|
| Kind of day | One stretch, with a paid break (the break counts as worked, s.40(a)) or A day in two parts, with an unpaid break (it comes off worked time, s.40(b)) | One stretch |
| Break length | 0 to 2 hours for a paid break; 1 to 3 hours for an unpaid one | 30 minutes |
| When the break comes off | For an unpaid break: only after this much work in a day, so a half day doesn't lose an hour. A paid break shows on days this long too | After 5 hours |
How Agoo counts it, every day:
- A paid break is never taken off. It's inside the hours worked, as the Act says, and the timesheet shows it beside the day: "30 min paid".
- An unpaid break comes off automatically on a finished day once its work reaches the threshold: an 08:00 to 17:00 day counts 8 hours, shown as "1 h unpaid, automatic". A day still running, or with a missing clock-out, keeps its paired time until it's finished; Agoo never guesses.
- Clocking out for lunch is the break. If someone clocks out and back in during the day, that time was never counted, so nothing more comes off ("42 min unpaid, clocked out"), whichever kind of day you run.
- A punched break replaces the automatic one, where you've switched on break punches. On a day in two parts, what they punched comes off instead of the scheduled break ("42 min unpaid, punched"); on a continuous day, a punched break is recorded inside the hours worked and nothing comes off ("35 min paid, punched").
- A shift can have its own break, paid, unpaid or none, which it keeps whatever the standard day says: a night ward with a paid half hour on a hospital that runs split days, for example. Set it on the shift's template, with when the break usually starts, and change it on a single roster shift if that day is different.
- The nursing hour is paid (Labour Act, s.57). HR switches it on for a nursing mother for up to a year, from Nursing hour in her attendance; it's never taken off. Agoo keeps only the dates, nothing about a pregnancy or a birth.
Break punches
Off by default. In Console → Attendance → Settings → Break punches, switch them on for your organisation, and keep them on or off at any site. The setup wizard and Home's checklist ask too. With them on:
- The kiosk (the app and the browser kiosk) and Agoo Workspace offer Start break to someone who's clocked in and End break to someone on a break, first, with the same ways of clocking in and the same evidence. Offline, the apps keep them like any punch.
- Someone on a break is still on site. Today shows On break, 12 min, and a roll call and the evacuation list count them.
- A break that wasn't ended before they clocked out is closed by the clock-out and flagged Break not ended in Needs review; the scheduled break stands in until you add the End break they missed.
- A long break (more than 15 minutes over the scheduled one) and a short unpaid break are flagged for you; what was punched still counts. No break recorded flags a day of 6 hours or more with no break, from the day you switch break punches on (you can turn that flag off).
- The nursing hour is a break of its own for people HR has switched it on for: Nursing break, paid and never taken off.
Two rules in Breaks decide how punched breaks count:
| Rule | What it does | Ghana's default |
|---|---|---|
| Take off at least the scheduled break | On a day in two parts, when someone punches a shorter lunch than the scheduled one, take the scheduled break off anyway | Off |
| Flag a long day with no break | Show a day of 6 hours or more with no break in Needs review | On |
"Take off at least the scheduled break" is off by default because time someone works through part of their break is still time worked: Agoo takes off what they punched and shows you the short break, so you can talk to them, rather than quietly counting less than they worked.
Which kind should you choose? Agoo suggests a day in two parts with an unpaid lunch hour when your standard day is 9 hours or longer (08:00 to 17:00 less the hour is the Act's 8 hours, s.33), and one stretch with a paid 30 minutes otherwise. Settings, the setup wizard and Home's checklist show the suggestion with Use this; nothing changes until you choose. A change applies from the day you pick, so earlier days keep the break they had.
Lateness and absence (Growth and above, with shifts)
| Setting | What it's for | Ghana's default |
|---|---|---|
| Lateness grace | Minutes after the start before someone counts as late | 5 minutes |
| Early-leave grace | Minutes before the end before someone counts as leaving early | 5 minutes |
| Absence alerts | Tell the line manager when someone's shift ended with no clock-in | On |
| Not-in-yet alerts | Tell the line manager when someone hasn't come in once a shift starts | Off |
Overtime
On every plan. How Agoo uses these is on Shifts and overtime.
| Setting | What it's for | Ghana's default |
|---|---|---|
| Daily and weekly hours | Hours after which time counts as overtime. On a shift, the day's hours are its paid length; with none, your standard day's, at least the daily hours | 8 a day, 40 a week |
| Daily overtime | Count time past the day's hours. Off, a working day has no daily limit and only the week counts | On |
| Weekly overtime | Count regular time past the week's hours | On |
| Overtime approval | Whether extra time must be approved by a manager before it counts | On |
| Averaging | Average the week over 2, 3 or 4 weeks from a Monday you choose, for longer days on a fixed timetable (s.34(b), s.36) | 1 week (no averaging) |
| Early arrivals (snap) | A clock-in up to this many minutes before a shift counts from its start, and a clock-out this soon after its end counts to it | 10 minutes |
| Rounding | Round other punches to the nearest 5, 6, 10 or 15 minutes, up or down | Off |
| Night time | Count time at night for an allowance you pay, between two times you choose | Off (22:00 to 07:00) |
Overtime starts after the hours your rules fix (Labour Act s.35(1)), and nobody may be required to work it unless you've fixed your overtime rates (s.35(2)). The law sets no rate, so Agoo counts the hours and your payroll pays them.
People with different hours, such as guards on 12-hour shifts, can follow a work-rule set of their own instead of these. Overtime approval stays the same for everyone.
Leave
| Setting | What it's for | Ghana's default |
|---|---|---|
| Leave year | The month your leave year starts | January |
| Annual leave | Working days of annual leave a year, from 15 (the Act's minimum) to 60 | 15 days |
| Unused annual leave | Carried into the next year in full, up to a number of days, or not at all | Carried in full |
The annual days here are your Annual leave type's allowance, and the carry-over is that type's. Your other leave types, such as maternity, sick and paternity leave, are set in Attendance → Leave → Types. See Leave.
Capping or ending carry-over is your choice, but forfeiting annual leave is legally uncertain in Ghana, and an agreement to give up annual leave is void (Labour Act s.31). Agoo warns you before you save.
Who approves leave
| Setting | What it's for | Default |
|---|---|---|
| Who approves leave | Line manager; Line manager, then HR; HR only; No approval; or, on Enterprise, a Custom chain (up to five steps: the line manager, their manager's manager, HR or a named person) | Line manager |
| If nobody decides | How long a request can wait with one approver before it moves up a level: after 24 hours, 48 hours, 72 hours or a week, or Off | 72 hours |
| A daily summary to approvers | One email a day to approvers who have requests waiting | On |
Kinds of leave that are simply recorded, such as sick leave, never wait for anyone. Someone with no manager goes to HR, and nobody decides their own request. Unlike the rest of the rules, it has no versions: a change applies to requests made from then on, and requests already waiting keep their steps. Saving or choosing Looks right ticks Who approves leave on Home's card, and each change is recorded in the audit trail as Changed who approves requests. See Leave.
Public holidays
Public holidays is on by default. Agoo keeps Ghana's list current for you, including the days declared each year, such as Eid al-Fitr, Shaqq Day (the day after it) and Eid al-Adha, and any day the government moves or adds, usually the day it's announced. A public holiday on a working day is paid (Labour Act s.72), and one inside someone's leave doesn't use their annual leave (s.22).
Turn it off only if your organisation doesn't follow Ghana's public holidays, such as some embassies and international schools.
When a public holiday is added, moved or taken off the list, Agoo works out your staff time again within minutes and emails your Owners and HR to say what changed, with a link to that month's timesheet.
Timesheets
| Setting | What it's for | Ghana's default |
|---|---|---|
| Each timesheet covers | Monthly, every two weeks or weekly; for monthly, the month can close on a cut-off day (1 to 28) | Monthly |
| Fortnights count from | For two-week periods, the Monday they're counted from | Monday 5 January 2026 |
| Who approves timesheets | Line manager, then HR; HR only; or No approval (each period locks itself). On Enterprise, a Custom chain of up to five steps | Line manager, then HR |
| Each period locks itself | With no approval, the days after a period ends before it locks, 1 to 14 | 3 days |
| Staff confirm their own timesheet first | Each person checks and confirms their timesheet in the Workspace app before it goes for approval | Off |
| They have … days after it ends | With staff confirming, the days they have after the period ends, 1 to 14; after that it goes for approval marked Not confirmed | |
| If nobody approves | How long a timesheet waits with an approver before it moves up to their manager, then HR | 2 days |
| Who can reopen an approved timesheet | HR, Owners and Admins; Line managers too; or Only Owners. Reopening always needs a reason | HR, Owners and Admins |
| Payroll is on | The day payroll runs: a day of the month for monthly periods, a weekday for weekly and fortnightly ones. Reminders to approvers and HR follow it | None |
A new period, or a new first Monday for fortnights, takes effect from the next period, never in the middle of one. Saving Who approves timesheets changes the timesheets still to come; those already waiting keep their steps. See Timesheets and payroll.
Pay codes (Pro and above)
Payroll files put each kind of time under a pay code: regular hours, daily and weekly overtime, rest-day work, public-holiday work, night time, absences, leave paid out on leaving and each leave type. Agoo starts from its own codes, such as REG, OT and PHW, with time and a half for overtime and double time for public-holiday work as common practice; the Labour Act sets no rate. Rename them, change the multipliers, or leave a kind of time out, on Attendance → Payroll. Pay codes aren't versioned like the rules: each payroll file keeps the codes it was made with. See Pay codes.
Changing the rules
Saving makes a new version of your rules. Choose when it starts:
- Today, the usual choice.
- An earlier date, up to 31 days back, to correct a recent mistake. It can't start before the version already in force.
- A later date, up to a year ahead, for a change you've agreed in advance, such as a new working week from 1 January. It shows as upcoming until then.
Days before the new version keep the rules they had. Each version lists when it started, who saved it and what changed, and each save is recorded in the audit trail as Changed the attendance rules.
Who can change them: anyone who manages attendance for the whole organisation: Owners, Admins, and HR or Site admins whose role covers every site. The leave and timesheet settings, and the pay codes and payroll layouts, also need the payroll permission, which only Owners, Admins and HR have. Everyone who can see attendance can read the rules.
Attendance in the Console
See who is in today and who didn't come in, authorise an absence, approve extra time, look at flagged punches and accept or reject them, add a missed clock-in or clock-out, correct a time, keep leave, approve and lock timesheets, make payroll files, open one person's attendance, and export daily hours.
Line managers and HR
Give each person a line manager, a start date and their employment details, so managers see their own team and HR keeps the records.