Docs
Attendance

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.

Early access· P8For owners, admins and HR

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.

ItemWhat it asksPlans
Working week and standard dayYour work days and the hours of a normal dayEvery plan
BreaksOne stretch with a paid break, or a day in two partsEvery plan
Lateness grace and absence alertsHow late counts as late, and who is toldGrowth and above
OvertimeWhen hours count as overtime, and whether it needs approvalGrowth and above
Leave year and annual leaveWhen your leave year starts, and the annual daysEvery plan
Public holidaysWhether Ghana's public holidays apply to youEvery plan
Timesheet period and approvalHow often timesheets close, who approves them and who can reopenEvery plan
Line managers"12 people on attendance have no manager"Every plan
Start datesPeople on attendance with no start date, needed for first-year leaveEvery plan
Employee numbersPeople on attendance with no employee number, needed for payroll filesPro 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

SettingWhat it's forGhana's default
Work daysThe days of your normal week. Leave counts working days from it.Monday to Friday
The day starts, endsThe standard day, for people without shifts08:00 to 17:00

Breaks

The Labour Act has two kinds of working day, and the kind decides whether the break is paid.

SettingWhat it's forGhana's default
Kind of dayOne 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 length0 to 2 hours for a paid break; 1 to 3 hours for an unpaid one30 minutes
When the break comes offFor 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 tooAfter 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)

SettingWhat it's forGhana's default
Lateness graceMinutes after the start before someone counts as late5 minutes
Early-leave graceMinutes before the end before someone counts as leaving early5 minutes
Absence alertsTell the line manager when someone's shift ended with no clock-inOn
Not-in-yet alertsTell the line manager when someone hasn't come in once a shift startsOff

Overtime (Growth and above, with shifts)

SettingWhat it's forGhana's default
Daily and weekly hoursHours after which time counts as overtime8 a day, 40 a week
Overtime approvalWhether extra time must be approved before it countsOn
AveragingAverage hours over up to 4 weeks, for longer days on a fixed timetable1 week (no averaging)
Early arrivalsA clock-in up to this many minutes early counts from the shift's start, so it isn't extra time10 minutes

Leave

SettingWhat it's forGhana's default
Leave yearThe month your leave year startsJanuary
Annual leaveWorking days of annual leave a year, from 15 (the Act's minimum) to 6015 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

SettingWhat it's forGhana's default
Timesheet periodMonthly, every two weeks or weekly; for monthly, an optional cut-off day (1 to 28)Monthly
Approval stepsLine manager, then HR; HR only; or No approval (each period locks itself)Line manager, then HR
Staff confirmingWhether each person confirms their own timesheet firstOff
Who can reopenHR, Owners and Admins; Line managers too; or Only Owners. Reopening always needs a reasonHR, Owners and Admins
Automatic lockingDays after a period ends before it locks by itself, 1 to 143 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.

On this page