Attendance rules and setup
Tell Agoo how your organisation works, from the working day and breaks 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 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 use your rules now; lateness, overtime, leave and timesheet approval use them as each one arrives.
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 four things, each filled in with Ghana's defaults: your working week and day, the kind of day, your leave year and annual leave, and the timesheet period and approval steps. 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 | Growth and above |
| Leave year and annual leave | When your leave year starts, and the annual days | 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 |
| Employee numbers | People on attendance with no employee number, needed for payroll files | Pro and above |
The last three tick themselves once nobody is missing, or when you choose Looks right. Items your plan doesn't include show which plan adds them and don't count. Rosters and payroll pay codes join the list when they arrive. 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. Breaks clocked at the kiosk or in the app work the same way.
- 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.
- 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.
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 (Growth and above, with shifts)
| Setting | What it's for | Ghana's default |
|---|---|---|
| Daily and weekly hours | Hours after which time counts as overtime | 8 a day, 40 a week |
| Overtime approval | Whether extra time must be approved before it counts | On |
| Averaging | Average hours over up to 4 weeks, for longer days on a fixed timetable | 1 week (no averaging) |
| Early arrivals | A clock-in up to this many minutes early counts from the shift's start, so it isn't extra time | 10 minutes |
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 |
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 |
|---|---|---|
| Timesheet period | Monthly, every two weeks or weekly; for monthly, an optional cut-off day (1 to 28) | Monthly |
| Approval steps | Line manager, then HR; HR only; or No approval (each period locks itself) | Line manager, then HR |
| Staff confirming | Whether each person confirms their own timesheet first | Off |
| Who can reopen | HR, Owners and Admins; Line managers too; or Only Owners. Reopening always needs a reason | HR, Owners and Admins |
| Automatic locking | Days after a period ends before it locks by itself, 1 to 14 | 3 days |
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 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, look at flagged punches and accept or reject them, add a missed clock-in or clock-out, correct a time, open one person's attendance, and export a timesheet.
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.