Version Control

FieldValue
Document titleKloktoba User Manual
Version number2.4
Release date27 October 2026
Document ownerTo be confirmed (product documentation owner)
ApproverTo be confirmed
Approval datePending approval
Next review dateWithin 90 days of release, and with each product release
StatusDraft for review

Owner, approver and dates must be completed by the organisation before publication.

Executive Summary

This release is a complete rewrite of the Kloktoba User Manual. The previous manual was a single in-app page of about 30 sections without screenshots. It described an earlier version of the product and omitted most of what Kloktoba now does, including breaks, attendance corrections, rota and shift swaps, overtime slots, reports, messaging, notifications, organisation structure and the audit log.

Future recommendations

Chapter 1

Introduction

What Kloktoba is, who it is for and how this manual is organised.

1.1 About Kloktoba

Kloktoba is a web-based workforce management platform. It lets organisations record when people work and where they clock in, manage breaks, rotas and overtime, handle leave and attendance corrections through approval workflows, maintain employee records and organisation structure, and report on all of it.

Kloktoba runs in a standard web browser on a computer, tablet or phone. There is nothing to install for end users.

1.2 Key benefits

BenefitWhat it means for you
Accurate time recordsEvery clock event is stamped with the server time and the device location, so timesheets are built from facts rather than memory.
Less adminTimesheets, hours against target, overtime and leave balances are calculated automatically.
Clear approvalsCorrections, leave, overtime, shift swaps and timesheets each follow a defined route and everyone sees the status.
Right access for each personMenus and screens are tailored to Employee, Supervisor, HR, Admin and SuperAdmin roles.
Audit-readyAttendance changes, approvals, sign-ins and administrative changes are written to a permanent, read-only audit log.

1.3 Key features

AreaFeaturesChapter
AttendanceClock in/out with location capture, lunch, flagged shifts, hours against targetChapter 4, Chapter 5
BreaksPaid and unpaid breaks, session limits, excessive-break alertsChapter 6
Leave and schedulingHoliday requests and balances, rota, shift swaps, overtime slots and requestsChapter 7
SupervisionApproval dashboard, team dashboard, approvals, team timesheets, two-step overtime approvalChapter 8
AdministrationEmployees, departments, positions, teams, business units, locations, shift templates, settingsChapter 3, Chapter 9
Security and accessRoles, menu permissions, account approvals, audit logChapter 10
Reporting18 report types including the Standard Salary Bill, the employee timesheet report, attendance analytics, monthly and date-range company timesheets, exportsChapter 11
CommunicationNotifications, messages, announcementsChapter 12

1.4 User roles

Every account has one role. Higher roles include what lower roles can do, plus more. Which menu items each role sees is controlled by Menu Permissions (Chapter 10), so your organisation may differ slightly from the defaults below.

RoleTypical responsibilities
EmployeeClock in/out, take breaks, view own timesheet and schedule, request leave, overtime, shift swaps and corrections, update own details, read messages.
SupervisorEverything an Employee does, plus: approve direct reports' corrections, leave, overtime requests, swaps and timesheets; recommend overtime worked over target; manage the team rota; run team reports; request overtime slots.
HREverything a Supervisor does for the whole organisation, plus: employee records, organisation structure, final approval of corrections and of overtime worked, overtime slots, flagged shifts, exports, the salary bill, break and attendance settings, audit log.
AdminEverything HR does, plus: company settings, menu permissions, organisation details, promoting Admins, app feedback, and deactivating or reactivating accounts.
SuperAdminRuns the platform, not an organisation: creates, edits, activates and deactivates organisations, creates Organisation Admins, activates, deactivates and resets them, manages subscription plans (priced per active user, with a minimum monthly price and a currency), generates monthly invoices, issues trial periods and deactivates organisations that do not pay, and views system statistics. SuperAdmin does not manage employees, approve leave or handle attendance.

1.5 How to use this manual

Chapter 2

Getting Started

Requirements, signing in, password reset and a tour of the screen.

2.1 System requirements and browser compatibility

ItemRequirement
BrowserA current version of Microsoft Edge, Google Chrome, Mozilla Firefox or Apple Safari (desktop or mobile).
DeviceAny computer, tablet or smartphone with a modern browser. A device with location services is needed to clock in and out.
ConnectionAn internet connection to your organisation's Kloktoba address.
LocationLocation access must be allowed for the Kloktoba site (see Clock In and Clock Out).
EmailAn email address on your account is needed to receive password reset links and email notifications.

2.2 Logging in

Purpose
Signs you in securely so Kloktoba can show the screens and data for your role.
Business benefit
Protects your records and ensures every action is attributed to the right person.
User roles
Employee Supervisor HR Admin SuperAdmin

Step-by-step instructions

  1. Open your organisation's Kloktoba address. You are taken to the sign-in page.
    Kloktoba sign-in page with username and password fields, Remember me, Log In button and links to create an account or reset a password.
    SS-001 – Sign-in page. Viewed as: Signed out.
    1. Username field
    2. Password field (use Show to reveal what you type)
    3. Log In button
    4. Forgot your password? link
  2. Enter your Username (not your email address) and Password. Select Show beside the password to check what you typed.
  3. Optionally tick Remember me to stay signed in on this device for 30 days. Without it you are signed out when you close the browser. Even so, a session times out after 8 hours of inactivity.
  4. Select Log In. You land on your Dashboard.
Sign-in page showing the generic message Invalid username or password after a failed attempt.
SS-002 – Sign-in error message. Viewed as: Signed out.
  1. The same message is shown whether the username or the password is wrong

Expected result

The Dashboard opens with your name and role shown at the top right and a sidebar of the screens your role can use.

Common errors

Error or mistakeWhat to do
"Invalid username or password."The same message is shown whether the username or the password is wrong, deliberately. Check caps lock and that you used your username, not your email.
A message that your account is awaiting approvalSelf-registered accounts need manager and HR/Admin approval first. See Account approvals.

Troubleshooting

ProblemSolution
Sign-in keeps failingUse Forgot your password? to set a new password. If that does not work, ask your Supervisor, HR or Admin to send you a reset link.

Frequently asked questions

Can I sign in with my email address?
No. Use the username you registered with or were given.
How long does a session last?
Up to 8 hours with activity, or 30 days if you chose Remember me on a trusted device.

2.3 Resetting your password

Purpose
Lets you choose a new password if you forget yours.
Business benefit
Restores access quickly without involving an administrator.
User roles
Employee Supervisor HR Admin SuperAdmin

Step-by-step instructions

  1. On the sign-in page select Forgot your password?.
    Forgot password page with a single email address field and a button to send a reset link.
    SS-003 – Forgot your password. Viewed as: Signed out.
    1. Email address on your account
    2. Send reset link
  2. Enter the email address on your account and select the send button.
  3. Open the email and select the link. It is valid for 24 hours and can be used once.
  4. Choose a new password that meets the rules shown under the box (set by your SuperAdmin; by default at least 8 characters), confirm it and save. Then sign in normally.

Expected result

You see the same confirmation message whether or not the email matches an account (to protect privacy). If it matches an active account, a link is sent.

Common errors

Error or mistakeWhat to do
The link has expired or was already usedRequest a new link. Each link works once and for 24 hours.

Troubleshooting

ProblemSolution
No email arrivesCheck your spam folder. If you have no email on file, ask your Supervisor (Team Members), HR or Admin (Employee List) to send you a link.

Frequently asked questions

Which password rules apply?
The rules shown under every password box. SuperAdmin sets them on Global Settings > Password policy: a minimum length (8 unless changed), optionally an uppercase letter, a lowercase letter, a number and a symbol, and never the username. Passwords may also expire after a set number of days: when yours has, signing in takes you to Change Password first.
Someone gave me a temporary password
Sign in with it. If you are asked to change it, enter it as the current password and choose your own. Nothing else is available until you do.

2.4 Creating an account (self-registration)

Purpose
Lets a new person request an account for approval.
Business benefit
Speeds up onboarding while keeping control with managers and HR.
User roles
Anyone (before signing in)

Step-by-step instructions

  1. On the sign-in page select Create account.
    Registration form asking for username, name, email, mobile number, organisation, manager and password.
    SS-004 – Create account (self-registration). Viewed as: Signed out.
    1. Unique username
    2. Organisation (choose first)
    3. Manager who approves your registration
  2. Enter a unique Username, your First Name (Other and Last Name are optional), optional Email Address and Mobile Number (start with + and digits only).
  3. Choose your Organisation first, then your Manager. The manager list only shows managers from that organisation.
  4. Enter and confirm a password that meets the rules shown under the box, then select Create Account.

Expected result

A Registration Pending page explains that two approvals are required before you can sign in.

Common errors

Error or mistakeWhat to do
Username already takenChoose another. Usernames are unique.
Manager list is emptySelect your Organisation first.

Troubleshooting

ProblemSolution
I registered but cannot sign inSee Account approvals. Contact your manager or HR if it is taking long.

Frequently asked questions

Can I choose my own role?
No. Self-registered accounts are always Employees.

2.5 Account approvals

Purpose
Controls which self-registered accounts become active.
Business benefit
Ensures only genuine staff gain access.
User roles
Supervisor HR Admin

Step-by-step instructions

  1. Open Account Approvals in the sidebar (Supervisor group). Two queues are shown.
    Pending Approvals page for self-registered accounts with two queues.
    SS-044 – Account approvals. Viewed as: HR.
    1. Manager approval queue
    2. HR/Admin approval queue
  2. Waiting on your approval lists registrations that named you as manager. Enter an optional note and select Approve or Reject.
  3. Waiting on HR/Admin approval (HR and Admin) lists registrations that the manager has already approved. Give final sign-off here.

Expected result

After both approvals the account becomes Active and the person can sign in. Rejection at either stage is final and the person is emailed.

Common errors

Error or mistakeWhat to do
"Already decided" messageSomeone else decided first; nothing is applied twice.

Troubleshooting

ProblemSolution
A registration is not in my queueOnly the chosen manager sees stage one. HR/Admin see stage two only after the manager approves.

Frequently asked questions

Can a rejected person re-apply?
A rejected account stays rejected. HR can create the employee directly with Add Employee.

2.6 First-time setup: the initial SuperAdmin

On a brand-new installation no accounts exist yet. The sign-in page then shows a link to create the initial SuperAdmin account. It opens a one-time setup page where you enter a username, name, email and password. The page and link disappear as soon as one SuperAdmin exists and cannot be run again. You are not signed in automatically; sign in with the new account afterwards.

One-time setup page used on a new installation to create the first SuperAdmin account.
SS-005 – First-time SuperAdmin setup. Viewed as: Signed out.

2.7 Dashboard overview

After signing in, Dashboard is your starting page. It combines a greeting with your next shift, quick action buttons, role-specific summary tiles, the clock widget, holiday and hours figures, and Quick access tiles for every screen you can reach.

Employee home page with greeting, quick action buttons, clock widget, holiday remaining, hours this month and quick access tiles.
SS-006 – Employee home dashboard. Viewed as: Employee.
  1. Quick actions
  2. Sidebar navigation (items depend on your role)
  3. Notifications

Dashboards by role:

DashboardWhereWhat it showsRoles
EmployeeDashboard, My DashboardClock status, break status, hours today, correction requests, unread messages and notifications, the week so far, holiday remaining.Everyone
SupervisorDashboard, Team AttendanceTeam size, attendance today, punctuality, on leave, overtime this week, approval queue, rota and probation or contract alerts.Supervisor and above
HRHR DashboardHeadcount, attendance rate, late and absent today, clocked in now, pending HR approvals, 14-day trend, action list.HR and above
AdministratorDashboard (company today)Company-wide tiles and action list, with Customise to choose what appears.Admin and above
Personal attendance dashboard showing clock status, break status, hours today, correction requests, unread items and the week so far.
SS-007 – My attendance dashboard. Viewed as: Employee.
  1. Current clock status
  2. Break status
  3. Corrections awaiting approval
Administrator home page with company today summary and action required list.
SS-037 – Administrator home dashboard. Viewed as: Admin.
  1. Action required
  2. Customise the dashboard

Sorting lists: on any table, select a column heading to sort ascending, select it again to sort descending. An arrow shows the column and direction. Your search text, filters and page size are kept, and long lists are sorted across all pages, not just the page you can see.

Employee list sorted by role, descending, with an arrow on the Role heading, a search box and a pager.
SS-075 – Sorting the employee list. Viewed as: HR.
  1. The arrow shows the sort column and direction
  2. Search keeps your sort

First sign-in with a new account: administrators created by a SuperAdmin, and people whose password was set for them, are asked to choose a new password before they can use Kloktoba.

The sidebar groups pages as Employee, Supervisor, Insights, HR and Admin, showing only the groups your role can use. Insights holds Reports, Team Insights and Data Insights. Admin holds the organisation's configuration, with an Organisation sub-group for the organisation profile, structure, branding and administrators. Select the arrow beside the logo to collapse the sidebar to icons, select a group heading to collapse that group, or select a sub-group (such as Organisation or Employees Management) to open or close it; the sidebar remembers what you left open. On a phone, open the menu with the menu button. Use the moon icon in the top bar to switch between light and dark theme.

Administrator sidebar with the Employee and Supervisor groups collapsed, showing the Insights group (Reports, Team Insights, Data Insights), the HR group and the Admin group with its Organisation sub-group open.
SS-089 – Sidebar: Insights and Admin groups. Viewed as: Admin.
  1. Insights: Reports, Team Insights and Data Insights
  2. Admin > Organisation: profile, structure, branding and administrators
  3. Select a group heading to open or close it

The status chip in the top bar (for example Clocked in since 09:03) always shows your current clock state. The envelope and bell icons open Messages and Notifications.

Signing out: open the menu under your name at the top right and choose Log out. You return to the sign-in page. Always sign out on shared devices.

Multi-factor authentication: Kloktoba does not currently offer multi-factor authentication. Protect your account with a strong, unique password and sign out on shared devices (see Chapter 14).

Chapter 3

Employee Management

Employee records, profiles, employee numbers and employment information.

3.1 Employee records and the employee list

Purpose
Holds the master record for every person: account, role, manager, pay, and organisation assignment.
Business benefit
One reliable source for who works where, under whom, with what allowances.
User roles
HR Admin

Step-by-step instructions

  1. Open HR > Employees Management > Employee List. Use Active Employees or Inactive Employees to filter by status.
    Employees list with name, username, email, role, manager, status and Edit, Send password reset link and Deactivate buttons.
    SS-038 – Employee list. Viewed as: Admin.
    1. Edit
    2. Send password reset link
    3. Deactivate
  2. Review Name, Username, Email, Role, Manager, Status, and any personal Allowance or Hours overrides. Pay rates are intentionally not shown on the list.
  3. Select Edit to open the record. You can change role, manager, allowance and hours overrides, pay rate, organisation assignment and the Allow clocking in/out switch (untick it to stop someone clocking while keeping their account and history).
    Edit Employee form for an existing employee.
    SS-040 – Edit Employee. Viewed as: Admin.
    1. Role
    2. Manager / Supervisor
  4. Use Send password reset link to help someone get back in, or Deactivate (Admin) to block sign-in without deleting history.

Expected result

The list reflects your changes immediately. A deactivated employee shows a Deactivated badge and an Admin can activate them again at any time. Someone whose Allow clocking in/out is switched off is left out of the Company Timesheet, team timesheets, the team rota, timesheet exports, attendance reports and analytics, because they cannot clock. They still appear on the Standard Salary Bill if they have a pay rate.

Common errors

Error or mistakeWhat to do
Cannot deactivate my own accountNot allowed. Ask another Admin.
Cannot find an employeeHR and Admin only see their own organisation.

Troubleshooting

ProblemSolution
Reset link says no email on fileEdit the employee and add an email address first.

Frequently asked questions

Is anything deleted when I deactivate?
No. Timesheets, leave and history are kept; access is simply blocked.

3.2 Adding an employee

Purpose
Creates an active account directly, without self-registration.
Business benefit
Onboards staff in one step with correct role, manager, organisation assignment and an employee number.
User roles
HR Admin

Step-by-step instructions

  1. Open Employees Management > Add Employee.
    Add Employee form with account details, role, manager, pay rate and organisation assignment fields.
    SS-039 – Add Employee. Viewed as: Admin.
    1. Username
    2. Email address (receives the set-password link)
    3. Department (required)
    4. Position (required)
    5. Employee number (assigned by the system)
  2. Enter Username, First Name, Last Name and Email Address. The email receives a link so the employee can choose their own password; there is no password field.
  3. Choose Role and Manager / Supervisor. Only Supervisor, HR and Admin accounts can be managers.
  4. Optionally set a holiday allowance override, weekly hours override and a pay rate. Enter just one of hourly, daily or annual and the other two are calculated.
  5. In Organisation assignment choose Department, Position, Business unit and Location (all required), and optionally Team, employment type, hire date, work mode, probation end and contract end dates.
  6. Select Create Employee.

Expected result

The account is active at once and an employee number such as DEMO000033 is generated automatically. The employee is emailed a set-your-password link.

Common errors

Error or mistakeWhat to do
Username already existsUsernames are unique; pick another.
Required field is emptyDepartment, Position, Business unit and Location are mandatory.

Troubleshooting

ProblemSolution
The set-password email failed to sendThe account is still created. Use Send password reset link on the Employee List to resend.

Frequently asked questions

Can I edit the employee number?
No. It is assigned by the system.
Which organisation does the employee join?
Yours. Only SuperAdmin sees an organisation selector.
New employee onboarding workflow. Seven steps in order: Administrator, Create employee, Assign department, Assign position, Employee number generated, User account created, Employee receives access.Administrator (HR orAdmin)1Create employee2Assign department3Assign position4Employee numbergenerated5User account created6Employee receivesaccess7
FL-004 – New employee onboarding workflow. The employee number is generated automatically on save. The employee is emailed a link to choose their own password.

3.3 Employee profile and My Details

Purpose
Lets each person keep their own contact and emergency details current.
Business benefit
Accurate contact data without waiting for HR.
User roles
Employee Supervisor HR Admin SuperAdmin

Step-by-step instructions

  1. Open Employee > My Details.
    My Details page with read-only account information, profile picture upload and editable personal and emergency contact details.
    SS-043 – My Details. Viewed as: Employee.
    1. Profile picture
    2. Personal details
    3. Emergency contact
  2. Upload a Profile picture (JPG, PNG or WEBP, up to 2 MB). It is cropped square and resized in your browser.
  3. Update First Name, Last Name, Mobile Number (start with + and the country code), Date of Birth and Home Address.
  4. Complete Emergency contact name and phone, then save.

Expected result

Your changes are saved. Colleagues see your name and photo in the Directory.

Common errors

Error or mistakeWhat to do
Mobile number rejectedIt must start with + followed by digits only, for example +447700900123.
Picture rejectedCheck the file type and that it is under 2 MB.

Troubleshooting

ProblemSolution
I need to change my username, email, role or organisationThese are read-only. Ask HR or Admin.

Frequently asked questions

Who can see my emergency contact?
Only HR and Admin through your employee record.

3.4 Directory and searching for people

Purpose
A simple company directory showing names and contact details.
Business benefit
Find a colleague's email or phone number in seconds.
User roles
Employee Supervisor HR Admin SuperAdmin

Step-by-step instructions

  1. Open Employee > Directory.
    Directory showing colleagues as cards with search, sort and grid or list switch.
    SS-042 – Directory. Viewed as: Employee.
    1. Search people
    2. Sort order
  2. Type in Search people, change the sort order and switch between Grid and List.
  3. Select a person to open their contact card, or use Email or Call.

Expected result

You see everyone in your organisation (SuperAdmin sees all organisations).

Common errors

Error or mistakeWhat to do
A colleague is missingThey may be inactive or in another organisation.

Troubleshooting

ProblemSolution
Photo shows initialsThe person has not uploaded a picture.

Frequently asked questions

Does the Directory show roles or pay?
No. Only name and contact details.

3.5 Employee numbers and employment information

Each employee receives a unique employee number when their record is created. The number is built from the organisation prefix (2 to 6 letters or numbers, set under Organisation Profile) and a running sequence, for example DEMO000012. Numbers cannot be edited. Changing the prefix later does not renumber anyone; new employees simply start a new series.

Employment information held on the record includes employment type (Full-time, Part-time, Contract, Temporary, Intern, Volunteer), hire date, work mode, probation end date and contract end date. Probation and contract end dates feed reminders on the HR dashboard: a review reminder 30 days before probation ends and a warning 60 days before a contract ends.

3.6 Assigning department, position, team and location

Purpose
Places each person in the organisation hierarchy: Organisation, Business unit, Department, Team, Employee.
Business benefit
Enables departmental reporting, overtime allowances and the right rota for each person.
User roles
HR Admin

Step-by-step instructions

  1. Open Employees Management > Employee Assignments.
    Employee assignments page with filters for business unit, department, team and position.
    SS-041 – Employee assignments. Viewed as: Admin.
    1. Filter the hierarchy
    2. Position filter
  2. Filter by Business unit, Department, Team and Position to narrow the list.
  3. Assign people in place by choosing their department, position, team, location and supervisor, then save.

Expected result

Reports, rotas and overtime allowances immediately use the new assignment.

Common errors

Error or mistakeWhat to do
A position is not offeredPositions belong to a department. Pick the department first.

Troubleshooting

ProblemSolution
Assignment will not saveCheck that required fields (department, position, business unit, location) are set.

Frequently asked questions

Where do I create departments or positions?
Under Admin > Organisation. See Chapter 9.

Chapter 4

Clock In and Clock Out

Recording when you start and finish work, with location captured at each event.

4.1 Attendance overview

Clocking is the foundation of your timesheet. Each clock event records the server time (so device clocks cannot be altered), your device location converted to a readable address, your IP address and your device and browser details. Kloktoba reads your location only at the moment you clock in, clock out, or start or end lunch. It does not track you at any other time. See the Privacy page for details.

Kloktoba-Geofence map of the day's clock-ins, with a different coloured pin for each employee and a legend.
SS-090 – Kloktoba-Geofence map. Viewed as: Admin.
  1. Choose the day
  2. A pin for each clock-in, coloured per employee
  3. Legend: which colour is which employee

4.2 Clocking in and clocking out

Purpose
Starts and ends your working shift.
Business benefit
Creates an accurate, tamper-resistant record of hours worked.
User roles
Employee Supervisor HR Admin SuperAdmin

Step-by-step instructions

  1. Open Clock In/Out in the sidebar, or use the widget at the top of your Dashboard. When you are clocked out only Clock In is enabled. The GPS ready chip shows location is available.
    Clock In / Clock Out page while clocked out: the Clock In button is enabled and Clock Out, Start Lunch and End Lunch are disabled; a GPS ready indicator is shown.
    SS-008 – Clock In screen (before clocking in). Viewed as: Employee2.
    1. Clock In (the only active button)
    2. GPS status - your browser asks for location permission the first time
    3. Current status
  2. Select Clock In. The first time, your browser asks to allow location. Choose Allow.
  3. Kloktoba records the event automatically. A green banner confirms the time and the top bar shows Clocked in since the time.
    Home page after clocking in: a green banner confirms the clock-in time, the top bar shows Clocked in since the time, and Clock Out and Start Lunch are now available.
    SS-009 – After clocking in - confirmation banner. Viewed as: Employee2.
    1. Confirmation banner with the recorded time
    2. Status chip in the top bar
    3. Clock Out is now the available action
  4. At the end of your shift open the same page. Clock Out is now enabled. A running timer shows your time on shift.
    Clock In / Clock Out page while clocked in: Clock Out and Start Lunch are enabled and Clock In is disabled.
    SS-010 – Clock Out screen (while clocked in). Viewed as: Employee2.
    1. Clock Out
    2. Start Lunch
    3. Elapsed time this shift
  5. Select Clock Out. A banner shows the clock-out time and your shift length.
    Home page after clocking out: a banner confirms the clock-out time and the shift length.
    SS-014 – After clocking out - confirmation banner. Viewed as: Employee2.
    1. Confirmation banner with the shift length
    2. Clock In available again

Expected result

The shift appears on My Timesheet and in team and company reports with the clock times and addresses.

Common errors

Error or mistakeWhat to do
"Permission to access location was denied."Allow Location for the Kloktoba site in your browser settings, reload and try again.
"You're already clocked in. Please clock out first."You have an open clock-in, possibly on another device. Clock out of that shift first.
All buttons are disabled with a message that clocking is turned offHR or Admin has switched off clocking for your account. Contact them.

Troubleshooting

ProblemSolution
GPS chip stays on "Checking location"Turn on device location services and allow your browser to use them, then reload.
I forgot to clock outAt the end of the day the system closes the shift at 23:59 and flags it (see Chapter 5). Ask HR to correct it, or submit an attendance correction.

Frequently asked questions

Can I clock in twice in a row?
No. Clock in and out must alternate. The buttons enable and disable accordingly and the server also checks.
Is my location tracked all day?
No. It is read only at clock in, clock out and lunch start or end.

4.3 Taking lunch from the clock widget

Purpose
Records a lunch period during an open shift.
Business benefit
Lunch time is excluded from hours worked automatically.
User roles
Employee Supervisor HR Admin SuperAdmin

Step-by-step instructions

  1. While clocked in, select Start Lunch on the clock widget when you leave.
  2. Select End Lunch when you return. Both capture your location like Clock In and Out.

Expected result

Lunch time is subtracted from your shift total on My Timesheet.

Common errors

Error or mistakeWhat to do
Start Lunch is disabledYou must be clocked in and not already on lunch.

Troubleshooting

ProblemSolution
I forgot End LunchSubmit an attendance correction so HR can fix the record.

Frequently asked questions

Is lunch the same as a break?
Lunch uses the clock widget. Paid and unpaid breaks use the Breaks page (Chapter 6).
Employee attendance workflow. Six steps in order: Employee, Clock In, Work day, Break, Clock Out, Attendance recorded.Employee1Clock In2Work day3Break (paid orunpaid)4Clock Out5Attendance recorded6
FL-001 – Employee attendance workflow. Location and server time are captured at Clock In and Clock Out. Lunch and breaks are recorded during the shift.

4.4 Manual attendance: requesting a correction

Purpose
Lets you ask for a missed or wrong clock-in or clock-out to be fixed.
Business benefit
Keeps timesheets accurate and every change approved and auditable.
User roles
Employee Supervisor HR Admin

Step-by-step instructions

  1. Open Employee > Attendance Corrections. Use the status filter to find earlier requests, then select New correction request.
    List of the employee's attendance correction requests with status filter and a New correction request button.
    SS-017 – My attendance corrections. Viewed as: Employee.
    1. New correction request
    2. Filter by status
    3. Request status
  2. Choose the Work date, then enter the Clock-in time and Clock-out time. Tick the next-day box if the shift ran past midnight.
    Form to request a correction: work date, clock-in and clock-out times, breaks, reason, note and optional attachment.
    SS-018 – Attendance correction form. Viewed as: Employee.
    1. Work date
    2. Clock-in time
    3. Clock-out time
    4. Reason (required)
    5. Submit for approval
    6. Save as draft
  3. Add any break periods with Add break, explain the Reason for adjustment (required) and optionally add a note to the approver and a supporting attachment (up to 5 MB).
  4. Select Submit for approval, or Save as draft to finish later.
Missed attendance (correction) workflow. Six steps in order: Employee, Submit attendance correction, Supervisor review, Approve Reject or Return, HR final approval, Timesheet updated.Employee1Submit attendancecorrection2Supervisor review3Approve, Rejector Return4HR final approval5Timesheet updated6
FL-003 – Missed attendance (correction) workflow. A Returned request goes back to the employee, who answers and resubmits. The timesheet changes only after HR (or Admin) gives final approval.

Expected result

The request is shown as Awaiting supervisor. Your timesheet only changes once HR gives final approval.

Common errors

Error or mistakeWhat to do
Date not acceptedCorrections can only go back as far as the limit set under Break & Attendance Settings (0 means unlimited).
More than one shift that dayChoose which shift you are correcting from the list shown.

Troubleshooting

ProblemSolution
The request was returnedYour supervisor asked a question. Open it, reply in the note and resubmit.

Frequently asked questions

Can I withdraw a request?
Yes. Use Cancel while it is still a draft, awaiting supervisor, returned or awaiting HR.
Who approves?
Your supervisor first, then HR or Admin for final approval.

Chapter 5

Attendance Management

How hours, overtime and exceptions are calculated and where to see them.

5.1 Attendance status

Each employee's day is classified for reports and dashboards:

StatusMeaning
PresentClocked in and out within the expected working day.
LateClocked in after the standard start time plus the late-arrival grace period.
IncompleteA clock-in without a matching clock-out.
AbsentNo attendance on a working day and not on approved leave.
OnLeaveApproved holiday covers the day.
NonWorkingDayWeekend or a day off.

5.2 My Timesheet and hours worked

Purpose
Shows your week, built automatically from clock events.
Business benefit
You can check and submit your own hours before approval.
User roles
Employee Supervisor HR Admin

Step-by-step instructions

  1. Open Employee > My Timesheet. Use Previous week and Next week to move between weeks.
    Weekly timesheet with previous/next week links, week total, target, holiday remaining and clock in and out times for each day.
    SS-015 – Attendance history - My Timesheet. Viewed as: Employee.
    1. Move between weeks
    2. Week total against target
    3. Daily clock-in, clock-out and hours
  2. Review Clock in, Clock out and Hours for each day, the Week total, your Target and how far over or short you are.
  3. When happy, select Submit for approval at the bottom. If it is rejected, Re-submit for approval appears.
  4. Open Timesheet Detail for clock times, break sessions and calculated hours day by day. Use Request a correction from here for any day.
    Daily timesheet grouped by week with clock times, break sessions and calculated hours.
    SS-016 – Daily timesheet detail. Viewed as: Employee.
    1. Request a correction for a day

Hours worked = clock-out minus clock-in, minus unpaid breaks and lunch. It is real elapsed time, so a night shift across the spring or autumn clock change counts the hours actually worked. The target is your weekly hours override, or the company standard (for example 37.5 hours a week) divided across five working days.

Expected result

Your supervisor (or HR/Admin) approves or rejects the week, with an optional note.

Common errors

Error or mistakeWhat to do
Hours look too lowUnpaid breaks and lunch are deducted. A missing clock-out needs a correction.

Troubleshooting

ProblemSolution
My week was rejectedRead the note beside the status, fix anything needed (via a correction if required) and re-submit.

Frequently asked questions

How is hours worked calculated?
Time between clock in and clock out, minus unpaid breaks and lunch. Paid breaks count as worked time.
Which timezone is used?
Times are shown in UK time.
What if I forget to end a break?
A break that is never ended stops at your clock-out, so it never wipes out the rest of the day. Submit a correction if the real break was shorter.

5.3 Overtime

Overtime is time worked beyond your weekly target. Going over target never stops you clocking in, but the extra hours only count, and are only paid, once they are approved. Until then the week counts at your weekly target. For example, with a 40-hour target, a 48-hour week counts as 40 hours until the extra 8 are approved.

How overtime is approvedWhat counts
Overtime requests and slots (approved in advance)Hours approved through an overtime request from an approved team overtime slot count automatically (see Chapter 7 and Chapter 8). The department's allowance, pay multiplier and weekly cap are set by HR.
Two-step approval of overtime worked (after the week)Any other hours over target need two approvals: your supervisor recommends them, then HR or Admin give the final approval, for all of the hours or only some of them. Only the final approval makes them count. If you have no supervisor, HR or Admin decide straight away.

The overtime status on a timesheet reads Awaiting supervisor, Awaiting HR (recommended), Approved (with the hours, when only some were approved), Rejected by supervisor or Rejected. While hours are not approved, timesheets show a Counted figure beside the hours worked, and an approved timesheet is approved for the counted hours (shown as Approved ... h (target)). If the overtime is approved later, the approved hours, the salary due and the reports rise to include it.

5.4 Overtime final approval

Purpose
Lets HR and Admin give the final decision on overtime worked over the weekly target.
Business benefit
Overtime is only paid once it has been reviewed by the supervisor and signed off by HR.
User roles
HR Admin

Step-by-step instructions

  1. Open HR > Overtime Final Approval. Each row is one person's week over target: Worked / target, Pre-approved (hours already approved through overtime requests), To decide, the Supervisor, the Status and the Final decision.
    Overtime final approval page listing weeks over target with worked and target hours, pre-approved and to-decide hours, the supervisor, status, and a form to give final approval for all or some of the hours.
    SS-086 – Overtime final approval. Viewed as: HR.
    1. Awaiting a decision, or all weeks over target
    2. How many weeks to look back
    3. Hours to approve (all, or fewer)
    4. Final approve (or Reject)
  2. Use Show to switch between Awaiting a decision and All weeks over target, and Weeks to look back over the last 4, 6, 8 or 12 weeks.
  3. For a recommended week, Hours to approve is filled in with all the hours to decide. Keep it to approve all of them, or enter a smaller number to approve only some. Add a note if wanted, then select Final approve, or Reject to refuse them.

Expected result

The approved hours count straight away on the Company Timesheet, in the salary due, the exports and the Monthly Approved Attendance report.

Common errors

Error or mistakeWhat to do
"Waiting for the supervisor's recommendation."The employee's supervisor has not recommended the hours yet.
"You made the recommendation, so another HR or Admin user must give the final approval."Ask another HR or Admin user. An Admin can do both steps.
Hours rejectedEnter between 0 and the hours still to decide.

Troubleshooting

ProblemSolution
A week is not listedOnly weeks over target appear. Hours already covered by an approved overtime request are not "to decide".

Frequently asked questions

Can I change a final decision?
Yes. Decide the week again; the latest decision applies.
Do approved hours earn the overtime premium?
The premium is paid on hours approved through overtime requests. Hours approved here count at the normal hourly rate.

5.5 Employee timesheet report

Purpose
Produces a one-person timesheet for any period, ready to download or send.
Business benefit
Gives employees and payroll a clear record of each working day and the approved overtime.
User roles
Employee Supervisor HR Admin

Step-by-step instructions

  1. Open Employee > Timesheet Report.
    Employee timesheet report page with employee, from and to fields, a Download Excel button and a form to send the report to the employee as an in-app message.
    SS-083 – Employee timesheet report. Viewed as: Supervisor.
    1. Choose the employee
    2. Period
    3. Download the report
    4. Send it to the employee with the file attached
  2. Choose the Employee (employees see themselves; supervisors their direct reports; HR and Admin anyone in the organisation) and the From and To dates, then select Update.
  3. Select Download Excel (.xlsx). The file lists each work date with clock-in, clock-out, shift duration, approved overtime and attendance status, and a total row.
  4. Supervisors, HR and Admin can add an optional message and select Send to employee (in-app message) to send the file to the employee as an attachment.

Expected result

The file downloads, or the employee receives an in-app message with the report attached.

Common errors

Error or mistakeWhat to do
Employee not in the listYou can only choose people you are allowed to see.

Troubleshooting

ProblemSolution
No days in the fileCheck the dates; only days with attendance or a status in the period are listed.

Frequently asked questions

Can employees send reports?
No. Employees can download their own; sending is for supervisors, HR and Admin.

5.6 Exceptions

5.7 Flagged shifts

Purpose
Lists shifts the system closed automatically because the employee forgot to clock out.
Business benefit
Prevents wrong hours distorting timesheets while making the issue visible.
User roles
HR Admin

Step-by-step instructions

  1. Open HR > Flagged Shifts. Each row shows the employee, clock-in and the auto-filled clock-out.
    Flagged Shifts page listing automatically closed shifts for correction.
    SS-045 – Flagged shifts. Viewed as: HR.
  2. Enter the real clock-out date and time (it must be after the clock-in) and select Save.

Expected result

The shift is corrected, no longer flagged, and drops off the list.

Common errors

Error or mistakeWhat to do
Time rejectedThe new clock-out must be later than the clock-in.

Troubleshooting

ProblemSolution
The list is emptyNobody has forgotten to clock out right now.

Frequently asked questions

Can supervisors fix flagged shifts?
They see a notice; only HR and Admin can correct them.

Chapter 6

Break Management

Recording paid and unpaid breaks and the rules that apply.

6.1 Starting and ending a break

Purpose
Records time away from work during a shift.
Business benefit
Unpaid breaks are deducted from worked hours; paid breaks count. Both are visible on the timeline.
User roles
Employee Supervisor HR Admin

Step-by-step instructions

  1. Clock in first. You cannot take a break while clocked out.
  2. Open Employee > Breaks. Choose the Break type: Unpaid (deducted from worked hours) or Paid (counts as worked time). The panel shows sessions used and the maximum minutes per break.
    Break tracking page with break type choice (paid or unpaid), Start break button and the rules for the day.
    SS-011 – Break Management - start a break. Viewed as: Employee2.
    1. Break type: Unpaid or Paid
    2. Start break
    3. Sessions used and the maximum minutes per break
  3. Select Start break. The status changes to On break and a timer runs.
    Break tracking page with a running break timer and the End break button.
    SS-012 – Break in progress. Viewed as: Employee2.
    1. End break
    2. Running timer
  4. When you return, select End break. The break appears under Today's breaks with start, end, type and minutes.
    Break tracking page after ending the break, listing the break session with start, end, type and minutes.
    SS-013 – Break ended - today's breaks. Viewed as: Employee2.
    1. Today's breaks with start, end, type and minutes

Expected result

The break is recorded on your timeline and timesheet detail and included in break reports.

Common errors

Error or mistakeWhat to do
Cannot start a breakYou are not clocked in, you have reached the daily session limit, or you are already on a break.
Break rejected or an alert raisedIt breaks a limit set in Break & Attendance Settings, such as the maximum minutes per break or the daily total.

Troubleshooting

ProblemSolution
I forgot to end a breakSubmit an attendance correction and add the break times.

Frequently asked questions

How many breaks can I take?
The default is 5 sessions a day, up to 90 minutes each, but your organisation sets these.

6.2 Break rules

HR and Admin set the rules under Admin > Break & Attendance Settings. They apply to everyone in the organisation, take effect immediately and are recorded in the audit log.

Break and attendance settings with break rules and working day thresholds.
SS-052 – Break and attendance settings. Viewed as: Admin.
  1. Break rules
  2. Late arrival and early departure rules
  3. Save settings
SettingEffect
Paid breaks enabled / Unpaid breaks enabledWhich break types employees can choose.
Minimum and maximum break duration (min)Shortest and longest allowed single break.
Max break sessions per dayDaily limit on break starts.
Excessive-break alert (total min/day)Total daily break minutes that triggers an excessive-break alert.
Standard start and end timeUsed to detect late arrival and early departure.
Late-arrival and early-departure grace (min)Tolerance before someone is marked late or early.
Corrections allowed back to (days)How far back employees may request corrections; 0 means unlimited.

Chapter 7

Leave Management

Holiday allowance and requests, plus rota, shift swaps and overtime requests.

7.1 Leave types and balances

Kloktoba manages annual holiday. Holiday years run 1 January to 31 December with no carry-over. Only weekdays (Monday to Friday) count, and there is no public-holiday calendar yet, so bank holidays are not excluded automatically. The smallest bookable unit is half a day.

Your Allowance is the company standard unless HR has set a personal override. Remaining = Allowance, minus Approved, minus Pending.

7.2 Requesting leave

Purpose
Books holiday and routes it for approval.
Business benefit
Clear balance and status for you; visibility of who is off for your supervisor.
User roles
Employee Supervisor HR Admin

Step-by-step instructions

  1. Open Employee > My Holiday. Four figures show Allowance, Approved / taken, Pending approval and Remaining.
    My Holiday page with allowance, approved, pending and remaining figures and a form to request holiday.
    SS-021 – Leave - allowance and request form. Viewed as: Employee.
    1. Allowance, approved, pending and remaining days
    2. Request form
    3. Half-day option
    4. Submit request
  2. Choose a Start date and End date. Tick Book as half day for a single half-day (start and end must match).
  3. Add an optional reason and select Submit request.
  4. Your request appears under My requests as Pending, with the approver shown once decided. Cancel is available only while it is Pending.
    My Holiday page after submitting a request, showing it as Pending in the My requests table with a Cancel button.
    SS-022 – Leave request submitted - history. Viewed as: Employee2.
    1. Request history with status
    2. Cancel (only while Pending)

Expected result

You see "Holiday request submitted ... awaiting approval". The Remaining figure drops to reflect the pending days.

Common errors

Error or mistakeWhat to do
Start date in the pastChoose a future date.
End before startCorrect the dates.
Dates overlap another pending or approved requestAdjust dates or cancel the other request.

Troubleshooting

ProblemSolution
I cannot cancel an approved requestCancelling is only possible while Pending. Contact your supervisor or HR.

Frequently asked questions

Will I be emailed when it is decided?
Check My Holiday for the status and decision note. Leave decisions are shown on the page.
Can I carry over days?
No. The year runs 1 January to 31 December.

7.3 Approving leave

Purpose
Lets supervisors, HR and Admin approve or reject holiday requests.
Business benefit
Prevents clashes and keeps balances accurate.
User roles
Supervisor HR Admin

Step-by-step instructions

  1. Supervisors open Team Holiday to see direct reports' requests. Pending requests show Approve and Reject with an optional note.
    Team Holiday page with pending requests and Approve and Reject buttons.
    SS-023 – Team Holiday - pending approval. Viewed as: Supervisor.
    1. Pending request
    2. Approve
    3. Reject
  2. HR and Admin open Company Holiday, filter by status, and decide any pending request in the organisation, including their own where no one is above them.
    Company Holiday page with status filter and every holiday request in the organisation.
    SS-024 – Company Holiday (HR/Admin). Viewed as: HR.
    1. Filter by status
Leave approval workflow. Six steps in order: Employee, Submit leave request, Supervisor review, Approve or Reject, Status shown on My Holiday, Balance updated.Employee1Submit leave request2Supervisor review3Approve orReject4Status shown on MyHoliday5Balance updated6
FL-002 – Leave approval workflow. Approved days count against the balance; a Pending request can be cancelled by the employee. HR and Admin can decide any request on Company Holiday.

Expected result

The employee sees the new status and your note on My Holiday, and approved days count against their balance.

Common errors

Error or mistakeWhat to do
Request already decidedOnly pending requests can be approved or rejected.

Troubleshooting

ProblemSolution
A request is missing from Team HolidayIt only lists your direct reports. HR and Admin use Company Holiday.

Frequently asked questions

Is there a leave calendar?
Not yet. Who is off in the next 14 days is shown on the Dashboard and My Timesheet.

7.4 My schedule, shift swaps and overtime

Purpose
Shows your published shifts and lets you swap shifts or book approved overtime.
Business benefit
You see your rota in advance and can resolve clashes with colleagues.
User roles
Employee Supervisor HR Admin

Step-by-step instructions

  1. Open My Schedule to see the shifts your manager has published for the week, scheduled hours and days off.
    Weekly schedule showing published shifts, scheduled hours and days off.
    SS-025 – My schedule. Viewed as: Employee.
    1. Scheduled hours for the week
    2. Start a swap
  2. To swap a shift with a colleague who has the same supervisor, start the swap from My Schedule. The colleague agrees first, then your supervisor approves. Track it under Shift Swaps.
  3. To book extra hours open My Overtime. You can only book from an approved team overtime slot, before working the hours or within 14 days afterwards, in steps of 15 minutes up to 12 hours.
    My overtime page with request form and request history.
    SS-027 – My overtime. Viewed as: Employee.
    1. Your overtime requests and their status

Expected result

Swaps and overtime requests show their status and decision notes.

Common errors

Error or mistakeWhat to do
No overtime slot availableAsk your supervisor to request a slot from HR or Admin.

Troubleshooting

ProblemSolution
I cannot swap with a colleagueBoth of you must have the same supervisor and their shifts must not overlap yours.

Frequently asked questions

Who approves overtime?
Your supervisor approves each request from an HR-approved slot.

Chapter 8

Supervisor Functions

Everything a Supervisor needs to manage a team. Also available to HR and Admin.

8.1 Approval dashboard

Purpose
Shows everything waiting for your decision in one place.
Business benefit
Nothing is missed and the oldest requests are dealt with first.
User roles
Supervisor HR Admin

Step-by-step instructions

  1. Open Supervisor > Approval Dashboard.
    Approval dashboard with a card for each approval type - timesheets, attendance corrections, overtime, shift swaps and holiday requests - showing the number waiting and the oldest items.
    SS-082 – Approval dashboard. Viewed as: Supervisor.
    1. Everything waiting for your decision
    2. One card per approval type, with a count
  2. Each card shows how many items are waiting, with the oldest few: Timesheets, Attendance corrections, Overtime (for HR and Admin this includes overtime worked that a supervisor has recommended and that needs final approval), Shift swaps and Holiday requests.
  3. Select an item, or the card's review link, to open the usual approval screen and decide it there.

Expected result

Counts go down as you decide items on their own screens.

Common errors

Error or mistakeWhat to do
A card shows "Couldn't load this section"That one approval type failed to load; the others are unaffected. Try again shortly.

Troubleshooting

ProblemSolution
An item is missingSupervisors see their direct reports; HR and Admin see their organisation.

Frequently asked questions

Can I approve from the dashboard?
No. It summarises and links; decisions are made on each approval screen so the usual rules always apply.

8.2 Team attendance and the team dashboard

Purpose
Shows who is in today, punctuality and what needs your decision.
Business benefit
Spot gaps early and clear your approval queue in one place.
User roles
Supervisor HR Admin

Step-by-step instructions

  1. Open Supervisor > Team Attendance.
    Team dashboard showing team size, attendance today, punctuality, on leave, overtime this week, pending approvals and an action required list.
    SS-031 – Team dashboard (Supervisor). Viewed as: Supervisor.
    1. Team size
    2. Attendance today
    3. Action required queue
  2. Review Team size, Attendance today, Punctuality, On leave, Overtime this week and Pending approvals.
  3. Work down Action required: swaps, overtime, corrections, and probation or contract reminders. Each row has a Review link.
Supervisor home page with team summary and action required list.
SS-030 – Supervisor home dashboard. Viewed as: Supervisor.

Expected result

Items disappear from the queue once you decide them.

Common errors

Error or mistakeWhat to do
The team shows zeroYou have no direct reports yet; HR assigns managers on the employee record.

Troubleshooting

ProblemSolution
A report is not listedOnly direct reports are included.

Frequently asked questions

What does Rostered today mean?
People with a published shift today and how many have not clocked in yet.

8.3 Team timesheets and recommending overtime

Purpose
Reviews your team's weekly hours, approves submissions and recommends overtime worked.
Business benefit
Timesheets and overtime are signed off before payroll.
User roles
Supervisor HR Admin

Step-by-step instructions

  1. Open Team Timesheets. Use the week links to move between weeks. Summary tiles show employees, hours, awaiting approval and over target.
    Team timesheet for the week with hours per day, total against target, the counted hours for weeks over target, the overtime status and the Recommend overtime and Don't recommend buttons.
    SS-032 – Team timesheets. Viewed as: Supervisor.
    1. People over their weekly target
    2. Hours that count until the overtime is approved
    3. Overtime status
    4. Step 1 of 2: recommend (or don't recommend) the overtime
  2. For a Pending week add an optional note and select Approve or Reject.
  3. For a week over target, select Recommend overtime or Don't recommend (step 1 of 2). HR or Admin then give the final approval (Overtime final approval). This is separate from approving the timesheet.
    Team timesheet after the supervisor recommended a week's overtime: a confirmation message and the status Awaiting HR (recommended).
    SS-081 – Overtime recommended by the supervisor. Viewed as: Supervisor.
    1. Confirmation: the overtime now needs final approval from HR or Admin
    2. New status

Expected result

Status updates for the employee. You can change your recommendation until HR or Admin decide. Until overtime has final approval the week counts at the target, shown as Counted on the row.

Common errors

Error or mistakeWhat to do
Cannot decide someone's timesheetSupervisors can only decide their direct reports. HR and Admin can decide anyone's.
"Only this person's supervisor can recommend their overtime."Recommending is for the employee's own supervisor.

Troubleshooting

ProblemSolution
Flagged badge shownA shift was auto-closed. HR corrects it from Flagged Shifts.

Frequently asked questions

Does rejecting overtime change pay?
Yes: hours over target that are not approved do not count, so the week is paid at the target.
What if the overtime was requested in advance?
Hours approved through an overtime request count automatically and are not part of this step.

8.4 Approval queues

Purpose
One place for each kind of request that needs your decision.
Business benefit
Predictable turnaround; employees always know the status.
User roles
Supervisor HR Admin

Step-by-step instructions

  1. Correction Approvals: on Awaiting my approval, open a request and Approve, Reject or Return it with a comment. Returning asks the employee for clarification.
    Correction approvals page listing requests from the supervisor's team with tabs for awaiting my approval, my team and all.
    SS-019 – Correction approvals (Supervisor). Viewed as: Supervisor.
    1. Queue awaiting your decision
    2. Everything your team has submitted
  2. HR and Admin use Awaiting HR approval to give final approval. Only then does the timesheet change.
    Correction approvals page for HR showing requests awaiting HR approval.
    SS-020 – Correction approvals (HR final approval). Viewed as: HR.
    1. HR gives the final approval that changes the timesheet
  3. Overtime Approvals: filter by Waiting for me, Decided or All, then Approve or Reject. You cannot decide your own request.
    Overtime approvals listing requests waiting for a decision with Approve and Reject buttons.
    SS-028 – Overtime approvals. Viewed as: Supervisor.
    1. Filter: waiting, decided, all
    2. Approve
    3. Reject
  4. Shift Swaps: under Waiting for my approval, Approve or Reject a swap once both colleagues have agreed.
    Shift swaps page with swaps waiting for supervisor approval.
    SS-026 – Shift swaps. Viewed as: Supervisor.
    1. Swaps waiting for your decision

Expected result

The employee is notified and the item moves to its next stage or final state.

Common errors

Error or mistakeWhat to do
Approve button missingThe item is not at your stage, or it is your own request.

Troubleshooting

ProblemSolution
A request seems stuckCheck which stage it is at: supervisor first, then HR for corrections.

Frequently asked questions

What does Returned mean?
You asked the employee a question. They update and resubmit.

8.5 Team rota, members and insights

Purpose
Plan shifts, support your team and see key metrics.
Business benefit
A published rota gives staff certainty and feeds attendance and lateness checks.
User roles
Supervisor HR Admin

Step-by-step instructions

  1. Open Team Rota. Drafts are visible only to you until you select Publish week. Use Copy last week to start from the previous rota.
    Team rota grid with Copy last week and Publish week buttons.
    SS-034 – Team rota. Viewed as: Supervisor.
    1. Copy last week
    2. Publish week
  2. Open Team Members to see direct reports and Send password reset link for anyone who is locked out.
    Team Members list of direct reports with a Send password reset link button.
    SS-033 – Team members. Viewed as: Supervisor.
    1. Send a password reset link
  3. Open Insights > Team Insights for headcount, the attendance trend, attendance analytics and holiday use for your team (Chapter 11).
    Team insights for direct reports with headcount, the attendance trend with a period picker, and attendance analytics.
    SS-035 – Team insights. Viewed as: Supervisor.
    1. Team Insights is under Insights in the sidebar
    2. Choose the trend period

Expected result

Published shifts appear on each person's My Schedule and notify them.

Common errors

Error or mistakeWhat to do
No shift templatesHR or Admin creates them under Shift Templates.

Troubleshooting

ProblemSolution
Reset link cannot be sentThe person has no email address on file.

Frequently asked questions

Can employees see draft shifts?
No. Only published shifts are visible to them.

8.6 Team reporting

Supervisors run reports for their direct reports from Insights > Reports. See Chapter 11. Exporting to Excel, CSV or PDF is available to HR and Admin. For one person's timesheet as a file, use the Employee timesheet report.

Chapter 9

Organisation Administration

Setting up the organisation, its structure, shifts and company-wide rules.

9.1 Organisation setup and profile

Purpose
Holds the organisation's name, prefix, address, contact details, logo and employee-number series.
Business benefit
Consistent identity and numbering across records.
User roles
Admin SuperAdmin HR

Step-by-step instructions

  1. Open Admin > Organisation > Organisation Profile.
    Organisation profile with name, prefix, address, contact details, logo and employee number series.
    SS-046 – Organisation profile. Viewed as: Admin.
    1. Prefix used in employee numbers
    2. Next employee number
    3. Save profile
  2. Complete Organisation name, Short name, Registration number, Organisation prefix (2 to 6 letters or numbers, unique) and address and contact fields. Upload a logo (PNG, JPEG, GIF or WebP up to 1 MB) if wanted.
  3. Check Employee numbers: the last issued and next number are shown. Select Save profile.
  4. Admins can also open Admin > Organisation > My Organisation to edit organisation details and promote an employee to Admin. SuperAdmin sees every organisation and can create new ones, activate or deactivate them and assign a subscription plan.
    Organisation edit page with an Admins section and Promote to Admin control.
    SS-055 – My Organisation and Admins. Viewed as: Admin.
    1. Promote an employee to Admin

Expected result

The profile is saved. New employees use the current prefix.

Common errors

Error or mistakeWhat to do
Prefix rejectedIt must be 2 to 6 letters or numbers and unique.

Troubleshooting

ProblemSolution
Numbers did not change after changing the prefixExisting numbers are never renumbered; new employees start a new series.

Frequently asked questions

Can I delete an organisation?
No. An organisation with employees cannot be removed.

9.2 Departments, positions, teams, business units and locations

Purpose
Defines the structure employees are assigned to.
Business benefit
Enables departmental reporting, correct overtime allowances and the right rota.
User roles
HR Admin

Step-by-step instructions

  1. Open Admin > Organisation > Departments. Select New department, enter a code, name and optional manager, then save. Use Edit or Deactivate on a row.
    Departments list with code, name, manager, employee count and status.
    SS-047 – Departments. Viewed as: Admin.
    1. New department
    2. Edit
    3. Deactivate
  2. Open Positions, select New position, and link it to a department.
    Positions list with code, name, department, employee count and status.
    SS-048 – Positions. Viewed as: Admin.
    1. New position
  3. Open Teams (linked to a department with a team leader) and Business Units the same way.
    Teams list with code, name, department, team leader, employee count and status.
    SS-049 – Teams and business units. Viewed as: Admin.
    1. New team
  4. Open Locations (work locations), select New location and enter code, name, city, country and postcode.
    Locations list with code, name, city, country, postcode and employee count.
    SS-050 – Locations (work locations). Viewed as: Admin.
    1. New location

Expected result

The new item can be selected on Add Employee, Employee Assignments and report filters.

Common errors

Error or mistakeWhat to do
Duplicate codeCodes are unique within the organisation.
Cannot deactivateReassign employees first if the item is in use.

Troubleshooting

ProblemSolution
An item is missing from a dropdownIt may be inactive. Reactivate it or choose another.

Frequently asked questions

What is the difference between a business unit and a department?
A business unit is a broader grouping (for example Head Office); departments sit within the organisation and teams within departments.

9.3 Shift management: templates and overtime allowances

Purpose
Defines reusable shift patterns and how much overtime each department may use.
Business benefit
Fast rota creation and controlled overtime spend.
User roles
HR Admin

Step-by-step instructions

  1. Open Admin > Shift Templates. Select Add template to define a shift name, code, start and end time, break and whether it runs overnight. Changing a template never changes shifts already on the rota.
    Shift templates list with time, break, paid hours and status.
    SS-051 – Shift templates. Viewed as: Admin.
    1. Add template
  2. Open Overtime Slots. Set each department's Allowance % (of its weekly target hours), Pay x multiplier and view the Weekly cap (h). Then decide slot requests from supervisors under Slots waiting for a decision.
    Overtime slots page with department allowance table and slots waiting for a decision.
    SS-029 – Overtime slots (HR/Admin). Viewed as: HR.
    1. Department allowance, pay multiplier and weekly cap
    2. Slot requests from supervisors

Expected result

Templates are available when building the rota. Approved slots let a team book overtime.

Common errors

Error or mistakeWhat to do
No overtime available to a teamA department with no allowance or 0% gets no overtime.

Troubleshooting

ProblemSolution
Slot cannot be approvedThe request exceeds the department cap. Reduce the hours or raise the allowance.

Frequently asked questions

What does Pay x mean?
The multiplier for approved overtime, for example 1.5 for time and a half.

9.4 Company settings and working hours

Purpose
Sets the standard holiday allowance, weekly hours and currency.
Business benefit
One place for company-wide defaults; individuals can have overrides.
User roles
Admin

Step-by-step instructions

  1. Open Admin > Settings. Cards link to each configuration task.
    Settings page with cards for each configuration task.
    SS-053 – Settings hub. Viewed as: Admin.
    1. Holiday allowance
    2. Working hours and currency
  2. Select Holiday Allowance to set the standard annual allowance.
  3. Select Working Hours to set standard hours per week and the currency used for pay rates and Salary due.

Expected result

Defaults apply to everyone without a personal override.

Common errors

Error or mistakeWhat to do
A person's allowance did not changeThey have a personal override on their employee record.

Troubleshooting

ProblemSolution
I cannot see SettingsIt is in the Admin group. Ask an Admin or check Menu Permissions.

Frequently asked questions

Are settings per organisation?
Holiday allowance, working hours and currency are company-wide.

9.5 Notification Management

Purpose
Lets you decide which messages the system sends, when, and what they say.
Business benefit
Staff get clear, consistent messages in your organisation's wording without a developer.
User roles
HR Admin

Step-by-step instructions

  1. Open Admin > Notification Management. The list shows every template with its type, code, active state and dates. Search, sort by clicking a heading, or filter by type and status.
    Notification Management with a searchable, sortable list of templates showing name, code, type, active state and effective dates, with Edit, Preview, Deactivate and Delete actions.
    SS-067 – Notification Management: templates. Viewed as: HR.
    1. Create a template
    2. Search templates
    3. Click a heading to sort; click again to reverse
  2. Select New notification (or Edit). Enter a name and a unique code, choose the type (Email, SMS, In-App or Push), then the subject and body. Insert placeholders such as {EmployeeName}, {LeaveType} or {OrganisationName}; tick HTML to use formatting. Set an effective date and, if wanted, an expiry date.
    Template editor with name, code, type, subject, body, HTML option, active switch, effective and expiry dates, the placeholder list and a live preview.
    SS-068 – Edit a notification template. Viewed as: HR.
    1. Subject (placeholders allowed)
    2. Body (plain text or HTML)
    3. Preview with sample values and your branding
  3. Select Preview to see the message with sample values and your branding before you save. Use Deactivate to pause a template without losing it; Delete asks you to confirm first.
  4. Open Triggers to choose which template is sent for each event: employee created or updated, clock in or out, missing clock in or out, leave, overtime and attendance correction submitted, approved or rejected, password reset and user created. Load recommended notifications creates a sensible starting set.
    Triggers page linking each of the seventeen events to a template, with an active switch per trigger.
    SS-069 – Notification triggers. Viewed as: HR.
    1. Which template fires for which event
  5. Open History to see what was sent, to whom and whether it was delivered. Audit shows who changed a template and when.
    Notification history listing each notification raised, its type, event and delivery status.
    SS-070 – Notification history. Viewed as: HR.
    1. Search the history

Expected result

When an event happens, the matching active template is sent to the right people in your organisation: the person concerned, their supervisor, HR and admins.

Common errors

Error or mistakeWhat to do
Code already usedEach template code is unique within your organisation.
Unknown placeholderOnly the listed placeholders are replaced; check the spelling.

Troubleshooting

ProblemSolution
Nothing was sentCheck the template is active and inside its effective and expiry dates, that a trigger links it to the event, and that the recipient has an email address.
SMS or push shows SkippedYour installation has no SMS or push gateway configured. Ask your administrator.

Frequently asked questions

Can a template contain scripts?
No. Scripts, event handlers and unsafe links are removed from HTML before saving and sending.
Do I see other organisations' templates?
Never. Everything is limited to your own organisation.

9.6 Notification Branding

Purpose
Applies your logo, colours and wording to every email and SMS the system sends.
Business benefit
Messages look like they come from your organisation.
User roles
HR Admin

Step-by-step instructions

  1. Open Admin > Organisation > Notification Branding. On General, upload a logo (PNG, JPEG, GIF or WebP) and set the organisation name, brand and secondary colours, footer, support email and phone, and website.
    Notification Branding with General, Email and SMS tabs and a live preview of the email.
    SS-071 – Notification Branding. Viewed as: Admin.
    1. Save branding
    2. Email styling tab
  2. On Email, set the header and footer background, button colour, font family and font colour. On SMS, set the sender name and signature.
  3. The preview on the right updates as you change a setting. Select Save branding.

Expected result

Every notification, including password resets and leave emails, uses the saved branding automatically. Text colours are adjusted to stay readable.

Common errors

Error or mistakeWhat to do
Colour rejectedUse a hex colour such as #1F6FEB.
Logo rejectedThe file must be a real image up to the size limit; renaming another file type does not work.

Troubleshooting

ProblemSolution
The logo does not show in an emailSome mail programs block images until you allow them.

Frequently asked questions

What if I set nothing?
Kloktoba's standard look is used.

9.7 Organisation Admins and platform administration

Purpose
The SuperAdmin creates and looks after each organisation's administrators and the platform.
Business benefit
Each organisation gets a named administrator, and organisations stay separate from the platform operator.
User roles
SuperAdmin

Step-by-step instructions

  1. Open Admin > Organisation > Organisation Admins and select Create organisation admin. Enter a username, first and last name, email and the organisation. The role is always Admin.
    Organisation Admins list with search, organisation filter, sortable columns and a Create organisation admin button.
    SS-072 – Organisation Admins. Viewed as: SuperAdmin.
    1. Create an organisation admin
  2. Under How will they sign in for the first time? choose to email them a link to choose their own password (the default), or Set a temporary password now - type it twice and decide whether they must choose their own password at first sign-in (recommended). A temporary password is never emailed: give it to them yourself. Select Create organisation admin; the creation is recorded with the date and who created it.
    Form with username, first and last name, email and organisation; the role is fixed to Admin.
    SS-073 – Create an organisation admin. Viewed as: SuperAdmin.
    1. Sends an activation email; a password change is forced at first sign-in
  3. From the list, Deactivate stops an admin signing in (their account and history are kept) and Activate lets a deactivated admin sign in again. Reset account emails a new activation link, and Set password sets a temporary password instead (optionally to be changed at first sign-in). Every change is recorded in the audit log, never the password itself.
  4. System Statistics shows organisations, users and notification volumes. Organisations creates, edits, activates and deactivates organisations and assigns a Subscription Plan; Global Settings holds platform-wide settings.
    System statistics showing organisations, users and notification volumes.
    SS-074 – System statistics. Viewed as: SuperAdmin.
  5. On Global Settings > Password policy set the rules every password must meet - a minimum length (6 to 64 characters) and whether it needs an uppercase letter, a lowercase letter, a number and a symbol - and after how many days passwords expire (0 = never). The rules apply from the next time anyone sets a password and are shown under every password box. When a password is older than the expiry, the next sign-in goes straight to Change Password. Changes are recorded in the audit log.

Expected result

The organisation has an administrator who then runs everything inside it.

Common errors

Error or mistakeWhat to do
Username or email already usedBoth must be unique.

Troubleshooting

ProblemSolution
The admin cannot sign inTheir organisation may be deactivated; reactivate it under Organisations.

Frequently asked questions

Can a SuperAdmin approve leave or edit employees?
No. SuperAdmin cannot create or edit employees, approve leave, manage attendance or do HR work; that belongs to each organisation's Admin and HR.

9.8 Subscription plans, invoices and trials

Purpose
Lets the SuperAdmin price each organisation's subscription, invoice it every month, give new organisations a free trial, and switch off organisations that do not pay.
Business benefit
Billing is handled in one place, in the right currency, and unpaid or expired accounts cannot keep using the system.
User roles
SuperAdmin

Step-by-step instructions

  1. Open SuperAdmin > Subscription Plans and create or edit a plan. Choose the Currency (for example GBP, USD, EUR or NGN), the Price per active user (per month) and, if wanted, a Minimum monthly price. Each invoice is the larger of (active users × price per active user) and the minimum, so a small organisation never pays less than the minimum. Leave the per-user price blank for a flat monthly price. Invoices use the currency of the plan.
    Edit subscription plan form with name, code, description, maximum employees, currency, price per active user and minimum monthly price.
    SS-079 – Subscription plan with currency. Viewed as: SuperAdmin.
    1. Currency used for pricing and invoices
    2. Price per active user per month
    3. Minimum monthly price
  2. Assign a plan to an organisation on SuperAdmin > Organisations. An organisation with no plan is not invoiced.
  3. Set who each organisation is billed to: on SuperAdmin > Organisations select Bill to beside the organisation and enter the billing name, who to mark invoices for the attention of, the accounts email and phone, the billing address, the organisation's VAT / tax number and an optional purchase order number. The organisation's own Admin can keep these up to date at Admin > Organisation > Billing Details. Invoices show them under Billed to; until they are saved, the organisation's name and profile address are used.
  4. Open SuperAdmin > Platform Owner (also on Global Settings) and enter your business details - legal and trading name, company and VAT numbers, address and billing contact - and the bank account organisations pay into: account name, bank, account number and sort code and/or IBAN and SWIFT / BIC, plus optional payment instructions, and upload your logo (PNG or JPEG, up to 1 MB). Every invoice then shows your logo and business details in its footer and your bank account under How to pay, below the Kloktoba header, with the invoice number as the payment reference. Bank details are checked (for example the IBAN check digits) and the audit log never records the full account number or IBAN.
  5. To have invoices paid automatically by Direct Debit through GoCardless, the organisation's Admin (or SuperAdmin) opens Billing Details and selects Set up Direct Debit. GoCardless's secure page opens, already filled in with the bill-to details; the payer enters their bank details there (Kloktoba never sees or stores them) and is brought back to Billing Details, which then shows the Direct Debit as Being set up and later Active. Direct Debit is available for invoices in GBP, EUR, USD, CAD and AUD; it can be cancelled at any time with Cancel Direct Debit.
  6. When you Generate invoices, each new invoice for an organisation with Direct Debit is sent to GoCardless at once, to be collected on its due date (or the first day the bank allows, if later). The invoice list and the invoice show the Direct Debit status and collection date. When GoCardless confirms the payment the invoice is marked Paid automatically, with the GoCardless payment as its reference; a failed payment leaves it unpaid, and a charge-back makes it unpaid again. On an unpaid invoice, Collect by Direct Debit (or Try Direct Debit again after a failure) sends it to GoCardless, and Check Direct Debit status fetches the latest status. Voiding an invoice cancels its payment if it has not yet gone to the bank.
  7. Open SuperAdmin > Invoices. Choose a Month and an organisation (or all organisations) and select Generate invoices. Each organisation gets one invoice per month, due 14 days after issue unless you choose another Due date (any day from today up to a year ahead) before generating. The number of active users (active accounts in that organisation, never the SuperAdmin) is counted on the day you generate. Organisations that are deactivated, have no plan or price, are covered by a trial, or were already invoiced are skipped, so generating twice never creates duplicates.
    Invoices page with outstanding totals per currency, a Generate invoices form, an Overdue accounts panel with a Deactivate button, and a sortable invoice list.
    SS-076 – Invoices and overdue accounts. Viewed as: SuperAdmin.
    1. Generate invoices for a month
    2. Record a payment
  8. Select an invoice number to open a printable invoice that shows how the amount was worked out (active users × price, or the minimum applied). Use Mark paid to record the date and a payment reference, or Void (with a reason) to cancel an unpaid invoice; a voided month can be invoiced again. To give an organisation more (or less) time, use Due date on the invoice list or Change due date on the invoice: an unpaid invoice can be due any day from its issue date up to a year after. A later due date takes it out of the overdue count, and a Direct Debit payment that is still only scheduled moves to the new date.
    A single invoice showing the organisation, issue and due dates, billing period, plan, employee count and total in the plan currency.
    SS-077 – A printable invoice. Viewed as: SuperAdmin.
    1. Print or save as PDF
    2. Total in the plan currency
  9. To send an invoice to the organisation, open it and select Email invoice. It goes to the billing email on the organisation's Billing Details, with the organisation's contact email (from its profile) copied in, and the invoice is attached as a PDF. The panel shows both addresses before you select Send email. If the organisation has no billing email yet, the panel says so and links to Billing Details. A paid invoice can be sent again for the organisation's records; a void invoice cannot be sent. Download PDF saves the same PDF that is attached. While an unpaid invoice's organisation has no Direct Debit (and GoCardless is set up), the invoice, the PDF and the email also explain how its Admin can set one up from Billing Details, so future invoices are collected automatically. Each email sent is recorded in the audit log.
  10. The Overdue accounts panel lists organisations with overdue unpaid invoices. When an organisation has three overdue unpaid invoices, select Deactivate (or Deactivate all at the limit) and confirm. Nobody in that organisation can then sign in until you activate it again on the Organisations screen. The reason and date are recorded.
  11. Open SuperAdmin > Trials & Access to issue a trial of 1 to 365 days to an organisation that has no plan, Extend it, End now or Remove it.
    Trials and access list showing each organisation, its plan, whether a trial is running, ended or the organisation is subscribed, with Issue trial, Extend, End now and Remove actions.
    SS-078 – Trials and access. Viewed as: SuperAdmin.
    1. Issue a trial of a number of days, or Extend one that is running
    2. End a trial now (locks the organisation unless it has a plan)
  12. When a trial ends and the organisation has no subscription plan, the application is locked down for that organisation: everyone in it is signed out and sees a message on the sign-in page. Assigning a plan lifts the lockdown at once.
    Sign-in page showing that the organisation trial period has ended and the application is locked.
    SS-080 – Sign-in blocked after a trial ends. Viewed as: Signed out.
    1. The lockdown message everyone in the organisation sees

Expected result

Invoices, payments, deactivations and trial changes are all recorded in the audit log. Other organisations are never affected.

Common errors

Error or mistakeWhat to do
Cannot invoice a future monthChoose the current month or an earlier one.
The due date cannot be before the issue dateChoose a due date on or after the day the invoice was issued, and no more than 365 days after it.
The due date can no longer be changedThe invoice is paid or void, or its Direct Debit payment has already gone to the bank.
Deactivate refusedThe organisation needs three overdue unpaid invoices. Invoices that are paid, voided or not yet due do not count.
Cannot issue a trialThe organisation is already on a plan or is deactivated.
GoCardless cannot collect payments in this currencyDirect Debit works only for GBP, EUR, USD, CAD and AUD plans. Invoices in other currencies are paid by bank transfer.
Direct Debit is not availableGoCardless has not been configured on the server (GoCardless:AccessToken). Invoices are paid by bank transfer until it is.

Troubleshooting

ProblemSolution
An organisation was not invoicedThe Generate message lists why: no plan, no price, covered by a trial, deactivated or already invoiced.
Users still locked out after payingPaying does not reactivate an organisation. Activate it on the Organisations screen.
Users locked out after a trialAssign a subscription plan, or extend or remove the trial.
A Direct Debit invoice is still unpaid after its collection dateOpen the invoice and select Check Direct Debit status. Bank payments take a few working days to be confirmed; if the payment failed, select Try Direct Debit again or ask the organisation to pay by bank transfer.

Frequently asked questions

Which currency is an invoice in?
The currency of the plan when the invoice was generated. Changing the plan later does not change invoices already issued.
Which users are charged for?
Active accounts in the organisation on the day the invoice is generated. Deactivated, pending and rejected accounts are not counted.
What if an organisation has hardly any users?
It is charged the plan's minimum monthly price instead.
Can an organisation admin see invoices?
No. Billing is only for the SuperAdmin.
Are existing organisations locked?
No. Only an organisation that has been given a trial and has no plan is locked when the trial ends.

9.9 Suggestions and App Feedback

Purpose
Collects improvement ideas about the application.
Business benefit
Direct line from staff to the product owner.
User roles
Employee Admin

Step-by-step instructions

  1. Anyone: open Suggest an Improvement, describe what to improve (5 to 2,000 characters), optionally attach a picture, and select Submit suggestion.
    Suggest an Improvement form.
    SS-066 – Suggest an improvement. Viewed as: Employee.
    1. Submit suggestion
  2. Admin: open App Feedback to see suggestions and select the send button to email all new ones to the developer in one message. They are then marked as sent.
    App Feedback page listing improvement suggestions with a button to send new ones to the developer.
    SS-057 – App feedback. Viewed as: Admin.
    1. Send new suggestions to the developer

Expected result

Submitters see a confirmation. Sent suggestions are never emailed twice.

Common errors

Error or mistakeWhat to do
Suggestion too shortEnter at least 5 characters.

Troubleshooting

ProblemSolution
Send button disabledThere are no new suggestions to send.

Frequently asked questions

Is this for HR requests?
No. Use Corrections, Holiday or contact HR for work requests.

Chapter 10

User and Role Management

Accounts, roles, who can see which menu, and security controls.

10.1 User accounts

Accounts are created by self-registration with approval (Chapter 2) or by HR and Admin with Add Employee (Chapter 3). Account status can be Active, Deactivated, or awaiting approval or rejected for self-registrations.

10.2 Roles

Kloktoba has five roles: Employee, Supervisor, HR, Admin and SuperAdmin. Change a person's role on Edit Employee. HR can assign Employee, Supervisor or HR; Admin can also grant Admin. A SuperAdmin account is created only through the one-time setup page, and Organisation Admins only by a SuperAdmin. A role change takes effect the next time the person signs in. Role definitions are fixed; you cannot create custom roles.

10.3 Permissions: Menu Permissions

Purpose
Chooses which roles see each navigation item.
Business benefit
Tailor the sidebar so people only see what they need.
User roles
Admin SuperAdmin

Step-by-step instructions

  1. Open Admin > Menu Permissions. Roles are columns and menu items are rows.
    Menu permission matrix with a checkbox for each menu item and each role.
    SS-054 – Menu permissions (role access). Viewed as: Admin.
    1. Roles across the top, menu items down the side
  2. Tick or untick a box to show or hide an item for a role.
  3. Changes apply within a few minutes and are recorded in the audit log.

Expected result

The sidebar updates for that role. Admin and SuperAdmin can never be locked out of Menu Permissions.

Common errors

Error or mistakeWhat to do
Cannot remove Menu Permissions for AdminAdmin and SuperAdmin must always see this page.

Troubleshooting

ProblemSolution
A user still sees the old menuWait a few minutes (menus are cached) and sign in again.

Frequently asked questions

Does hiding a menu item stop access?
Showing or hiding is a convenience only. Every screen is separately protected, so hiding never grants access and showing never bypasses security.

10.4 Security controls

ControlDetail
PasswordsRules and expiry set by SuperAdmin on Global Settings > Password policy (default: at least 8 characters, no expiry); stored securely; reset links last 24 hours and work once; temporary passwords are never emailed.
Generic sign-in errorsThe same message for a wrong username or password, to avoid revealing which accounts exist.
SessionsSign-in lasts up to 8 hours with activity, or 30 days if Remember me is chosen.
Role-protected screensEvery screen checks permission regardless of menu visibility.
Organisation scopingHR, Admin and Supervisor see only their own organisation. SuperAdmin manages organisations but not their employees or records.
ApprovalsSelf-registrations need manager and HR/Admin approval.
Multi-factor authenticationNot currently available.

10.5 Audit log

Purpose
A permanent, read-only record of attendance changes, approvals, breaks, messaging, sign-ins and administrative changes.
Business benefit
Evidence for investigations, compliance and support.
User roles
HR Admin

Step-by-step instructions

  1. Open Admin > Audit Log.
    Audit log with date, entity and action filters and a read-only list of entries.
    SS-056 – Audit log. Viewed as: Admin.
    1. Filter by entity
    2. Filter by action
  2. Filter by date range, Entity and Action, or search by user, IP address or details.
  3. Page through results with Newer and Older.

Expected result

Entries cannot be edited or deleted, even by database administrators using SQL.

Common errors

Error or mistakeWhat to do
No resultsWiden the date range or clear filters.

Troubleshooting

ProblemSolution
I cannot find an actionUse the Entity filter first, then Action.

Frequently asked questions

Are exports logged?
Yes. Every export is recorded.

Chapter 11

Reports and Analytics

Built-in reports, live analytics and exports.

11.1 Running a report

Purpose
Produces tabular attendance, adjustment, break, messaging and productivity information.
Business benefit
Answers management and compliance questions without spreadsheets.
User roles
Supervisor HR Admin

Step-by-step instructions

  1. Open Insights > Reports. Supervisors see their direct reports; HR and Admin see their whole organisation. People whose clocking is switched off are left out of attendance reports.
    Reports page, opened from Insights in the sidebar, listing report types by category with filters.
    SS-058 – Reports - choose a report. Viewed as: Supervisor.
    1. Insights group: Reports and Team Insights
    2. Pick a report
    3. Run report
  2. Choose a report from the list: Daily and Monthly Attendance, Monthly Submitted Attendance, Monthly Approved Attendance, Missing Clock-In, Missing Clock-Out, Late Arrival, Early Departure, Attendance Adjustment, Approval Audit Trail, Break Utilisation, Excessive Break Usage, Internal Messaging Activity, Broadcast Message (HR and Admin), Overtime, Employee Hour Summary, Department Attendance Summary and Standard Salary Bill (HR and Admin).
  3. Set filters: dates, employee, department, team, business unit, location, supervisor, role and attendance status.
  4. Select Run report. Use the search box and column sorting on the results, which also show totals.
    Daily attendance report results with Excel, CSV and PDF export buttons.
    SS-059 – Attendance report results and export. Viewed as: HR.
    1. Export to Excel
    2. Export to CSV
    3. Export to PDF
Monthly Approved Attendance report with, per employee and month, weeks worked and approved, hours worked and approved, days, approved overtime and who approved.
SS-088 – Monthly Approved Attendance report. Viewed as: HR.
  1. Monthly approved (and submitted) attendance reports

Expected result

Results appear below the filters. Export controls are enabled after a run.

Common errors

Error or mistakeWhat to do
No rowsWiden the date range or relax filters.

Troubleshooting

ProblemSolution
Export buttons are disabledRun a report first. Export is available to HR and Admin.

Frequently asked questions

Which formats can I export?
Excel, CSV and PDF.
How do the monthly submitted and approved reports work?
Each week belongs to the month its Monday falls in. Monthly Submitted Attendance counts, per employee and month, the weeks worked, submitted, pending, approved, rejected and not submitted, and the hours submitted. Monthly Approved Attendance shows the approved weeks, the hours worked in them, the Hours Approved (over-target weeks count at the weekly target unless the overtime was finally approved), approved overtime and who approved them.

11.2 Standard Salary Bill

Purpose
Shows what the organisation pays for everyone's standard hours: each employee's pay weekly, monthly and annually, and the total salary bill.
Business benefit
A quick, consistent figure for budgeting that does not depend on hours worked.
User roles
HR Admin

Step-by-step instructions

  1. Open Insights > Reports and choose Standard Salary Bill under Pay.
    Standard Salary Bill report with weekly, monthly and annual salary bill totals and a row per employee with standard hours, hourly rate, weekly, monthly and annual pay and pay basis.
    SS-087 – Standard Salary Bill. Viewed as: HR.
    1. In the Pay group (HR and Admin only)
    2. Weekly, monthly and annual totals
    3. Export to Excel, CSV or PDF
  2. Optionally filter by department, team, business unit, location or role, then select Run report. Dates do not change the figures; the report shows pay as it stands today.
  3. Read the totals: Weekly salary bill, Monthly salary bill, Annual salary bill and Employees included. Export to Excel, CSV or PDF if needed.

Expected result

One row per employee with a pay rate: Standard Hours / Week, Hourly Rate, Weekly, Monthly, Annual and Pay Basis (hourly rate or annual salary). Amounts are in the company currency.

Common errors

Error or mistakeWhat to do
The report is not in my listIt shows pay, so only HR and Admin can see and run it.

Troubleshooting

ProblemSolution
Someone is missingEmployees with no pay rate, or a rate of zero, are not shown. Set a pay rate on their employee record.
An annual figure differs slightly from the stored salaryWhen an hourly rate is stored it is used (hourly rate x hours x 52), the same rule as Salary due on the Company Timesheet; the stored annual salary may have been rounded differently.

Frequently asked questions

How is it calculated?
Standard hours are the person's weekly hours override, or the company standard. Weekly = hourly rate x standard hours; Annual = weekly x 52; Monthly = annual / 12. If only an annual salary is stored, it is spread over the standard hours.
Does it include overtime?
No. It is based on standard hours, not hours worked.
Are people who cannot clock in included?
Yes, if they have a pay rate. They are still on the payroll.

11.3 Analytics: Data Insights and Team Insights

Data Insights (HR and Admin) and Team Insights (Supervisor, for direct reports) are under Insights. They are live, read-only views recalculated each time you open them: headcount by role, the attendance trend, attendance analytics, hours against target this week and holiday use.

SectionWhat it shows and how to change it
Attendance trendHow many active employees clocked in on each day (or week). Choose a Period (This week, Last 7, 14 or 30 days, This month, Last 90 days, or a Custom range of up to a year); a preset applies straight away, a custom range when you select Show trend. Up to 35 days shows a bar per day; longer periods a bar per Monday-start week. Tiles show the average, the busiest day or week and who is clocked in now.
Attendance analyticsChoose a Period (Last 8, 12, 26 or 52 weeks, or a Custom range of up to a year) and what to Compare (Week on week and month on month, Week on week or Month on month). Tiles show scheduled days, the attendance rate, the unplanned absence rate, approved leave days and missing clock-ins to review. The comparison shows each week (or month) against the one before, with the change.
Weekly attendance rateLine chart: attended days divided by attended days plus unplanned absences, for each Monday to Sunday week.
Monthly absence rateLine chart: unplanned absences divided by attended days plus unplanned absences, for each month. Approved leave is not included.
Lateness by departmentBars: late arrivals divided by days attended, per department. Late means after the start time plus the grace period.
Absence by weekday and weekHeat map of unplanned absences for each weekday in each week; darker cells are a larger share of that day's expected attendance. A dash means nobody was expected.
Missing clock-ins to reviewScheduled days with no clock-in and no approved leave, with a link to the Missing Clock-In report.
Data Insights page with headcount by role and the attendance trend chart, with a period picker and tiles for the average, busiest day and who is clocked in now.
SS-060 – Data Insights: headcount and attendance trend. Viewed as: HR.
  1. Headcount by role
  2. Attendance trend
  3. Choose the period (or a custom range)
Attendance analytics with period and compare choices, tiles for scheduled days, attendance rate, unplanned absence, leave and missing clock-ins, week-on-week and month-on-month comparisons, line charts for weekly attendance and monthly absence, lateness by department and an absence heat map.
SS-084 – Data Insights: attendance analytics. Viewed as: HR.
  1. Analytics period
  2. Compare week on week, month on month, or both
  3. Comparison with the previous week
  4. Weekly attendance rate
  5. Absence heat map
HR command centre with headcount, attendance rate, late and absent counts, trend chart and action list.
SS-036 – HR command centre. Viewed as: HR.
  1. Headcount
  2. Attendance rate
  3. Clocked in now

11.4 Timesheet exports

Purpose
Download attendance for any period.
Business benefit
Feed payroll and external systems; every export is audited.
User roles
HR Admin

Step-by-step instructions

  1. On HR > Company Timesheet choose a week and select Export CSV or Export Excel. Files include over-target and auto clocked-out flags, the overtime status, Counted hours (after the overtime rule), Approved hours and salary due where a pay rate exists.
    Company Timesheet with Monthly / date range, Export CSV and Export Excel buttons, summary tiles and every employee's weekly hours with counted hours and salary due.
    SS-061 – Company timesheet and exports. Viewed as: HR.
    1. Month or date-range view
    2. Export CSV
    3. Export Excel
    4. Hours that count until overtime is approved
  2. For a month or any date range, select Monthly / date range on the Company Timesheet. Choose a Month and Show month, or From and To dates (up to 93 days) and Show range. The page shows each person's hours day by day and week by week, the counted and approved hours and salary due; Export CSV and Export Excel download the same period. Weekly view returns to the week.
    Company Timesheet for a month with month and date-range pickers, previous and next month links, export buttons and each employee's hours by day and week with counted and approved hours.
    SS-085 – Company timesheet: month or date range. Viewed as: HR.
    1. Choose a month
    2. Or any date range (up to 93 days)
    3. Export the same period
    4. Back to the week
  3. For any period open Timesheet Export, choose a Quick period or dates, filter by employee, and export. Each file has employee details, one row per day and a summary.
    Timesheet export centre with quick periods and filters.
    SS-062 – Timesheet export centre. Viewed as: HR.
    1. Quick periods
    2. Filters

Expected result

A file downloads; the export is recorded in the audit log.

Common errors

Error or mistakeWhat to do
Salary due shows a dashNo pay rate is set for that person; they are excluded from the total.
Salary due is lower than hours x rateHours over the weekly target without approved overtime are not paid until the overtime is approved (Overtime).

Troubleshooting

ProblemSolution
Excel opens with strange charactersImport the CSV as UTF-8.

Frequently asked questions

Does CSV include a title row?
No. CSV is pure data so it imports cleanly.

Chapter 12

Notifications and Messages

Alerts, announcements and how to control them.

12.1 Notification centre

Purpose
Collects alerts about approvals, rota changes, reminders and announcements.
Business benefit
You never miss an approval or a missing clock event.
User roles
Employee Supervisor HR Admin

Step-by-step instructions

  1. Select the bell in the top bar or open Notifications. Tabs show Unread, History and Preferences.
    Notification centre with unread items, history and preferences tabs.
    SS-063 – Notification centre. Viewed as: Admin.
    1. Mark all as read
    2. Notification preferences
    3. A system alert
  2. Select Open to go to the item, Mark as read for one, or Mark all as read.
  3. Open Preferences to choose, for each notification type, whether you receive it in the app and by email.
    Notification preferences with in-app and email choices for each notification type.
    SS-064 – Notification preferences. Viewed as: Admin.

undefined Approval notifications

When a correction, overtime request, slot or swap needs your decision, you receive a Supervisor approval required or HR approval required notification. When it is decided, the requester is told. Email notifications use the Kloktoba email template with your organisation's support address.

Expected result

Unread items stay highlighted until opened or marked read. The bell shows the unread count.

Common errors

Error or mistakeWhat to do
Not receiving emailsCheck your Preferences and that your account has an email address.

Troubleshooting

ProblemSolution
A notification disappearedCheck History.

Frequently asked questions

Which events notify me?
Missing clock-in or clock-out, attendance correction submitted, approved, rejected or returned, approvals required, overtime requested or decided, schedule published, shift changes, swap requests and decisions, new messages, announcements and read receipts, excessive breaks, and (for HR and Admin) unapproved overtime: a week over target with no final overtime decision.

12.2 Messages and announcements

Purpose
Internal messaging with folders and broadcast announcements.
Business benefit
Keep work communication inside Kloktoba with read receipts.
User roles
Employee Supervisor HR Admin

Step-by-step instructions

  1. Open Messages. Folders are Inbox, Sent, Drafts and Archive.
    Messages page with Inbox, Sent, Drafts and Archive folders and New message and Broadcast buttons.
    SS-065 – Messages. Viewed as: Admin.
    1. New message
    2. Announcements and emergency broadcasts
  2. Select New message to write to a colleague. Select a message to read it; use Archive, Mark unread or Delete.
  3. Authorised users can use Broadcast / announcement to send a company or department announcement or an emergency message.

Expected result

Messages show in the recipient's Inbox with an unread count in the top bar.

Common errors

Error or mistakeWhat to do
Cannot broadcastBroadcasts are limited to authorised roles.

Troubleshooting

ProblemSolution
Message not foundCheck Archive or the Everything view.

Frequently asked questions

Do broadcasts notify people?
Yes, as a broadcast announcement notification.

Chapter 13

Troubleshooting

Common issues, messages and where to get help.

13.1 Common issues

SymptomLikely causeWhat to do
"Permission to access location was denied."Browser blocked location for the Kloktoba site.Open site settings, set Location to Allow, reload, retry.
GPS chip never turns readyDevice location services are off.Turn on location services; try Wi-Fi or mobile data; reload.
"You're already clocked in."Open shift from earlier or another device.Clock out of that shift first.
Clock buttons are disabled with a noticeClocking switched off for your account.Contact HR or Admin.
Cannot sign in after registeringAwaiting manager and HR/Admin approval.Ask your manager or HR.
Reset link does not workExpired (24 h) or already used.Request a new one.
Cannot start a breakNot clocked in, limit reached or already on break.Check status on Breaks; see break rules.
Timesheet hours look shortUnpaid breaks and lunch are deducted; missing clock-out.Check Timesheet Detail; request a correction.
Cannot cancel holidayOnly Pending requests can be cancelled.Contact your supervisor or HR.
Page not in my sidebarRole or Menu Permissions do not include it.Ask your Admin.
No overtime slot to bookTeam has no approved slot.Ask your supervisor to request one.
Cannot see SettingsIt is in the Admin group.Ask an Admin.
Cannot find Reports, Team Insights or Data InsightsThey moved to the Insights group.Open Insights in the sidebar.
Cannot find Shift Templates, Audit Log or the organisation settingsThey moved to the Admin group (organisation settings are under Admin > Organisation).Open Admin in the sidebar.
Week shows fewer hours than worked ("Counted")Hours over the weekly target have no final overtime approval yet.Supervisor recommends, then HR or Admin approve on Overtime Final Approval.
Someone is missing from the Company TimesheetTheir clocking is switched off.Turn on Allow clocking in/out on their employee record if they should clock.

13.2 Error messages

MessageMeaning
Invalid username or password.Credentials did not match. Same message for both cases.
Permission to access location was denied.The browser did not allow location access.
You're already clocked in. Please clock out first.An open clock-in exists.
The password must be at least ... characters long / must contain ...Choose a password that meets every rule listed under the password box (SuperAdmin > Global Settings > Password policy).
Your password has expiredEnter your current password and choose a new one; the policy sets how many days a password lasts.
Admin and SuperAdmin must always be able to see Menu Permissions.You tried to hide the screen that controls menus from Admin or SuperAdmin.
Only Admin can manage menu permissions.Your role cannot change menu permissions.

13.3 Frequently asked questions

13.4 Support contacts

First contact your Supervisor or HR. For application problems, email support@klocktoba.com (the address configured for this installation) and include your username, the page, what you expected and what happened. Use Suggest an Improvement for ideas.

Chapter 14

Best Practices

Recommended habits for compliance and security.

14.1 Attendance compliance

14.2 Leave governance

14.3 Supervisor responsibilities

14.4 Administrative guidelines

14.5 Security best practices

Appendix A Screenshot Index

All 90 screenshots were captured from the current build against a demonstration database with fictitious data. Yellow numbered markers identify the items described in each figure's key.

Screenshot index
IDScreenshotViewed asPageUsed in
SS-001Sign-in pageSigned out/Account/LoginChapter 2
SS-002Sign-in error messageSigned out/Account/LoginChapter 2
SS-003Forgot your passwordSigned out/Account/ForgotPasswordChapter 2
SS-004Create account (self-registration)Signed out/Account/RegisterChapter 2
SS-005First-time SuperAdmin setupSigned out/Setup/SuperAdminChapter 2
SS-006Employee home dashboardEmployee/Chapter 2
SS-007My attendance dashboardEmployee/OverviewChapter 2
SS-008Clock In screen (before clocking in)Employee2/AttendanceChapter 4
SS-009After clocking in - confirmation bannerEmployee2/AttendanceChapter 4
SS-010Clock Out screen (while clocked in)Employee2/AttendanceChapter 4
SS-011Break Management - start a breakEmployee2/BreaksChapter 6
SS-012Break in progressEmployee2/BreaksChapter 6
SS-013Break ended - today's breaksEmployee2/BreaksChapter 6
SS-014After clocking out - confirmation bannerEmployee2/AttendanceChapter 4
SS-015Attendance history - My TimesheetEmployee/DashboardChapter 5
SS-016Daily timesheet detailEmployee/TimesheetChapter 5
SS-017My attendance correctionsEmployee/AdjustmentsChapter 4
SS-018Attendance correction formEmployee/Adjustments/CreateChapter 4
SS-019Correction approvals (Supervisor)Supervisor/Adjustments/ApprovalsChapter 8
SS-020Correction approvals (HR final approval)HR/Adjustments/ApprovalsChapter 8
SS-021Leave - allowance and request formEmployee/HolidayChapter 7
SS-022Leave request submitted - historyEmployee2/HolidayChapter 7
SS-023Team Holiday - pending approvalSupervisor/Holiday/TeamChapter 7
SS-024Company Holiday (HR/Admin)HR/Holiday/AllChapter 7
SS-025My scheduleEmployee/ScheduleChapter 7
SS-026Shift swapsSupervisor/Schedule/SwapsChapter 8
SS-027My overtimeEmployee/OvertimeChapter 7
SS-028Overtime approvalsSupervisor/Overtime/ApprovalsChapter 8
SS-029Overtime slots (HR/Admin)HR/Overtime/SlotsChapter 9
SS-030Supervisor home dashboardSupervisor/Chapter 8
SS-031Team dashboard (Supervisor)Supervisor/Overview/TeamChapter 8
SS-032Team timesheetsSupervisor/Dashboard/Team?week=2026-10-19Chapter 8
SS-081Overtime recommended by the supervisorSupervisor/Dashboard/Team?week=2026-10-19Chapter 8
SS-082Approval dashboardSupervisor/ApprovalDashboardChapter 8
SS-083Employee timesheet reportSupervisor/TimesheetReport?employeeId=8Chapter 5
SS-033Team membersSupervisor/Employees/TeamChapter 8
SS-034Team rotaSupervisor/Schedule/RotaChapter 8
SS-035Team insightsSupervisor/Insights/TeamChapter 8
SS-036HR command centreHR/Overview/HrChapter 11
SS-037Administrator home dashboardAdmin/Chapter 2
SS-038Employee listAdmin/EmployeesChapter 3
SS-039Add EmployeeAdmin/Employees/CreateChapter 3
SS-040Edit EmployeeAdmin/EmployeesChapter 3
SS-041Employee assignmentsAdmin/Employees/AssignmentsChapter 3
SS-042DirectoryEmployee/DirectoryChapter 3
SS-043My DetailsEmployee/Account/MyDetailsChapter 3
SS-044Account approvalsHR/Account/PendingApprovalsChapter 2
SS-045Flagged shiftsHR/Attendance/FlaggedChapter 5
SS-046Organisation profileAdmin/OrganisationSettings/ProfileChapter 9
SS-047DepartmentsAdmin/OrganisationSettings/DepartmentsChapter 9
SS-048PositionsAdmin/OrganisationSettings/PositionsChapter 9
SS-049Teams and business unitsAdmin/OrganisationSettings/TeamsChapter 9
SS-050Locations (work locations)Admin/OrganisationSettings/LocationsChapter 9
SS-051Shift templatesAdmin/Schedule/TemplatesChapter 9
SS-052Break and attendance settingsAdmin/Breaks/SettingsChapter 6
SS-053Settings hubAdmin/SettingsChapter 9
SS-054Menu permissions (role access)Admin/AdminMenusChapter 10
SS-055My Organisation and AdminsAdmin/Organisation/MyOrganisationChapter 9
SS-056Audit logAdmin/AuditChapter 10
SS-057App feedbackAdmin/FeedbackChapter 9
SS-058Reports - choose a reportSupervisor/ReportsChapter 11
SS-059Attendance report results and exportHR/ReportsChapter 11
SS-060Data Insights: headcount and attendance trendHR/InsightsChapter 11
SS-084Data Insights: attendance analyticsHR/Insights?arange=custom&compare=both&afrom=2026-10-05&ato=2026-11-01Chapter 11
SS-061Company timesheet and exportsHR/Dashboard/All?week=2026-10-19Chapter 11
SS-085Company timesheet: month or date rangeHR/Dashboard/PeriodChapter 11
SS-086Overtime final approvalHR/Dashboard/OvertimeReviewChapter 5
SS-087Standard Salary BillHR/Reports?report=salary-billChapter 11
SS-088Monthly Approved Attendance reportHR/Reports?report=monthly-approved-attendanceChapter 11
SS-062Timesheet export centreHR/ExportChapter 11
SS-063Notification centreAdmin/NotificationsChapter 12
SS-064Notification preferencesAdmin/NotificationsChapter 12
SS-065MessagesAdmin/MessagesChapter 12
SS-066Suggest an improvementEmployee/Feedback/SubmitChapter 9
SS-067Notification Management: templatesHR/NotificationManagementChapter 9
SS-068Edit a notification templateHR/NotificationManagementChapter 9
SS-069Notification triggersHR/NotificationManagement/TriggersChapter 9
SS-070Notification historyHR/NotificationManagement/HistoryChapter 9
SS-071Notification BrandingAdmin/NotificationBrandingChapter 9
SS-072Organisation AdminsSuperAdmin/OrganisationAdminsChapter 9
SS-073Create an organisation adminSuperAdmin/OrganisationAdmins/CreateChapter 9
SS-074System statisticsSuperAdmin/PlatformChapter 9
SS-075Sorting the employee listHR/Employees?sort=role&dir=descChapter 2
SS-076Invoices and overdue accountsSuperAdmin/BillingChapter 9
SS-077A printable invoiceSuperAdmin/BillingChapter 9
SS-078Trials and accessSuperAdmin/Billing/TrialsChapter 9
SS-079Subscription plan with currencySuperAdmin/SubscriptionPlans/Edit/1Chapter 9
SS-080Sign-in blocked after a trial endsSigned out/Account/Login?reason=trial-expiredChapter 9
SS-089Sidebar: Insights and Admin groupsAdmin/OrganisationSettings/ProfileChapter 2
SS-090Kloktoba-Geofence mapAdmin/Geofence?date=2026-10-19Chapter 4

Appendix B Change Log

Section updatedDescription of changeAuthorDateVersion
AllComplete rewrite. Replaced single in-app page with a 14-chapter manual.Documentation (AI-assisted draft, pending human review)27 October 20262.0
Cover, Contents, Version controlNew cover page, clickable contents, version control page and executive summary.Documentation (AI-assisted draft, pending human review)27 October 20262.0
Chapter 2 Getting StartedRewrote sign-in, password reset, registration and approvals; added system requirements, dashboards and a note that multi-factor authentication is not available.Documentation (AI-assisted draft, pending human review)27 October 20262.0
Chapter 3 Employee ManagementAdded employee numbers, organisation assignment (department, position, team, business unit, location), employment fields and the onboarding workflow.Documentation (AI-assisted draft, pending human review)27 October 20262.0
Chapters 4 to 6Rewrote clock in/out; new coverage of lunch, flagged shifts, corrections, breaks and break rules.Documentation (AI-assisted draft, pending human review)27 October 20262.0
Chapter 7 Leave ManagementRewrote leave; new coverage of rota, shift swaps and overtime requests.Documentation (AI-assisted draft, pending human review)27 October 20262.0
Chapter 8 Supervisor FunctionsNew: team dashboard, approval queues, rota, team reporting.Documentation (AI-assisted draft, pending human review)27 October 20262.0
Chapters 9 and 10New: organisation setup and structure, shift templates, overtime allowances, company settings, menu permissions, security controls, audit log.Documentation (AI-assisted draft, pending human review)27 October 20262.0
Chapters 11 and 12New: reports, analytics, exports, notifications, messages.Documentation (AI-assisted draft, pending human review)27 October 20262.0
Chapters 13 and 14Expanded troubleshooting and new best practices chapter.Documentation (AI-assisted draft, pending human review)27 October 20262.0
AppendicesAdded screenshot index, change log, workflow index, role access summary, coverage notes, accessibility review and audit summary.Documentation (AI-assisted draft, pending human review)27 October 20262.0
Notification Management and BrandingNew: templates, triggers, history and audit for the 17 notification events; organisation branding applied to every email and SMS.Documentation (AI-assisted draft, pending human review)27 October 20262.1
Organisation Admins and SuperAdminNew: SuperAdmin creates Organisation Admins only, with activation email and forced password change; SuperAdmin no longer performs employee, leave or attendance functions.Documentation (AI-assisted draft, pending human review)27 October 20262.1
SortingEvery list sorts by clicking a heading (ascending, then descending) with filters and paging kept.Documentation (AI-assisted draft, pending human review)27 October 20262.1
Per-user pricingSubscription plans are priced per active user per month with an optional minimum monthly price; invoices show the calculation.Documentation (AI-assisted draft, pending human review)27 October 20262.3
Subscription plans, invoices and trialsNew: plan currency, monthly invoices, deactivation of organisations with three overdue unpaid invoices, trial periods and the lockdown when a trial ends.Documentation (AI-assisted draft, pending human review)27 October 20262.2
NavigationNew Insights group (Reports, Team Insights, Data Insights); Admin and Administration merged into Admin with an Organisation sub-group; Shift Templates, Break & Attendance Settings and Audit Log moved to Admin; collapsible sub-groups.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Chapter 5 OvertimeHours over target count only once approved; two-step approval (supervisor recommends, HR or Admin give final approval for all or some hours); new Overtime final approval and Employee timesheet report sections; break and clock-change rules for hours worked.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Chapter 8 Supervisor FunctionsNew Approval dashboard; team timesheets now recommend overtime.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Chapter 11 Reports and AnalyticsNew Monthly Submitted and Monthly Approved Attendance reports, Standard Salary Bill, attendance trend and analytics charts with week-on-week and month-on-month comparison, and the monthly and date-range Company Timesheet with exports.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Subscription plans, invoices and trialsNew: Platform Owner - the business details and bank account printed on every invoice as From and How to pay; invoices also show the organisation's address.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Subscription plans, invoices and trialsNew: Bill to - who each organisation's invoices are billed to, set by SuperAdmin (Organisations > Bill to) or the organisation's Admin (Admin > Organisation > Billing Details).Documentation (AI-assisted draft, pending human review)27 October 20262.4
Subscription plans, invoices and trialsNew: SuperAdmin sets the due date when generating invoices and can change it on any unpaid invoice.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Subscription plans, invoices and trialsNew: Direct Debit through GoCardless - organisations set it up from Billing Details; invoices are collected on their due date and marked paid automatically when GoCardless confirms payment.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Subscription plans, invoices and trialsNew: SuperAdmin emails an invoice as a PDF to the billing email, copying the organisation contact email, and can download the PDF.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Subscription plans, invoices and trialsNew: invoices show the platform owner's logo (uploaded on Platform Owner) and the Kloktoba logo, and explain how to set up Direct Debit when the organisation has not.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Subscription plans, invoices and trialsChanged: invoices have a new design - a navy Kloktoba header, the status beside the dates, the amount due in a navy block, payment options side by side, and the platform owner in the footer.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Employees and rolesNew: Admin activates any account that cannot sign in (deactivated, waiting for approval or rejected) with one Activate button; SuperAdmin activates and deactivates Organisation Admins.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Employees and rolesNew: temporary passwords - SuperAdmin for Organisation Admins, HR and Admin for their organisation - with a choice to force a change at first sign-in; a SuperAdmin password policy (length, character types, expiry).Documentation (AI-assisted draft, pending human review)27 October 20262.4
ScreenshotsAll screenshots recaptured from the current build with the new sidebar; 10 new (SS-081 to SS-090): overtime recommendation, approval dashboard, timesheet report, attendance analytics, monthly company timesheet, overtime final approval, salary bill, monthly approved report, sidebar groups and the geofence map.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Chapters 3, 4, 12 and 13Clock-in-disabled employees left out of timesheets and attendance reports; Kloktoba-Geofence map; unapproved overtime notification; new troubleshooting rows.Documentation (AI-assisted draft, pending human review)27 October 20262.4
Previous manual (in-app page)Superseded. Sections for removed or renamed screens (for example "Pending Approvals" naming, "Company Timesheet" locations) were replaced by current screen names.Documentation (AI-assisted draft, pending human review)27 October 20261.x

Appendix C Workflow Diagram Index

IDWorkflowWhere it appears
FL-001Employee attendanceClocking in and out
FL-002Leave approvalApproving leave
FL-003Missed attendance (correction)Manual attendance
FL-004New employee onboardingAdding an employee

Role access summary (default menu)

Menu itemsEmployeeSupervisorHRAdmin
Dashboard, My Dashboard, Clock In/Out, Breaks, Attendance Corrections, My Timesheet, Timesheet Detail, My Schedule, Shift Swaps, My Overtime, My Holiday, Messages, Notifications, My Details, Directory, Suggest an ImprovementYesYesYesYes
Team Attendance, Team Timesheets, Team Members, Team Holiday, Team Rota, Correction Approvals, Overtime Approvals, Overtime Slots, Account Approvals, Team Insights, ReportsNoYesYesYes
HR Dashboard, Employee List, Add Employee, Active and Inactive Employees, Employee Assignments, Organisation Settings (Profile, Departments, Positions, Teams, Business Units, Locations), Flagged Shifts, Company Timesheet, Timesheet Export, Company Holiday, Shift Templates, Break & Attendance Settings, Data Insights, Audit LogNoNoYesYes
Settings, Menu Permissions, My Organisation, App FeedbackNoNoNoYes

Defaults observed in the current build. Admins can change visibility under Menu Permissions. SuperAdmin sees everything Admin sees across all organisations.

Appendix D Coverage Notes: Brief versus Product

Where the documentation brief listed a capability that Kloktoba does not currently provide, this manual says so rather than describing something that does not exist.

Item in briefWhat the product doesHow the manual handles it
Multi-factor authentication screensNot available in the applicationDocumented as not available (Chapter 2, Chapter 10).
GPS attendance verification (blocking by location)Location is captured and stored with each clock event; there is no geofence or location check that blocks a clock-inDocumented as location capture, with a note.
Holiday calendarNo public-holiday calendar; "who is off in the next 14 days" is on the Dashboard and My TimesheetDocumented as such.
Role management and permission management screensFive fixed roles; Menu Permissions controls menu visibility only; screens are protected separatelyDocumented as Menu Permissions.
User management as a separate moduleAccounts are managed through Employees (create, edit, reset, deactivate) and Account ApprovalsDocumented under Employee Management and Chapter 10.
Email notification screenshotsEmails are sent only when a mail sender is configured; none in the demo environmentDescribed in text; screenshot to be added.
Registration pending, password reset form and logout confirmation screensReached only through a live registration or emailed linkDescribed in text; screenshots to be added.
Rejected or approved request screenshots as separate capturesShown as statuses within the approval and history screensCovered by SS-019 to SS-028.
Product spellingUser-facing text now reads "Kloktoba"; code identifiers, file names and the klocktoba.com addresses still use the older spellingRename identifiers and confirm the domain separately if wanted.

Appendix E Documentation Audit Summary

Findings from the audit of the previous manual (the single in-app User Manual page).

AreaFindingRisk
Missing featuresBreaks, corrections, rota, shift swaps, overtime slots and requests, reports, exports, messages, notifications, audit log, menu permissions, departments, positions, teams, business units, locations, employee numbers, directory details were not documented.High
Outdated contentDescribed Settings as HR/Admin hub with an organisation-wide screens list that no longer matches the sidebar; used old screen names such as My Team, Pending Approvals, Data Insights, Company Holiday groupings.High
Incomplete workflowsNo workflow for corrections, onboarding or approvals beyond registration; no overtime or swap process.High
Inconsistent terminologyMixed "Team Timesheet" and "Team Timesheets", "My Team" and "Team Members", "Insights" naming.Medium
Missing screenshotsThe previous manual contained no screenshots at all.High
Missing business process explanationsNo benefits, roles per feature, errors or FAQs per feature.Medium
Grammar and formattingLong paragraphs, inconsistent muted notes, no consistent callouts or step numbering.Medium
NavigationOne long page with a single contents list; no previous or next links, no cross references between chapters.Medium
BrandingProduct name came from configuration (Klocktoba); no cover, logo, tagline, version or copyright; no consistent look.Medium
TroubleshootingSix entries only; no error message list or support contacts.Medium
RisksStaff could not discover features; support load; inconsistent approvals; compliance gaps in how corrections and overtime are handled.High

Accessibility review summary

CheckResultStatus
Font sizesBody text 11 pt (print) / 16 px (web); headings scale up; tables 10 to 10.5 pt.Pass
Colour contrastText colours on backgrounds checked to at least 4.5:1: navy #001F4D on white (16:1), dark teal #0F6F73 on white (5.9:1), callout text colours on their tints (all above 4.5:1). Teal #16C6C8 is used only decoratively, never for text on white.Pass
Screen reader supportLandmarks (header, nav, main), skip link, table captions and header scopes, figures with captions, diagrams with titles.Pass
Alt textEvery screenshot has a descriptive alt text (80 of 80); diagrams have a title and description; decorative markers are hidden from assistive technology.Pass
Keyboard navigationAll links are keyboard focusable with a visible focus outline. The manual documents Ctrl+K search in the application.Pass
Heading hierarchyOne H1 per document; chapters H2; sections H3; feature parts H4. No levels skipped.Pass
Hyperlink accessibilityLinks use descriptive text (for example "Chapter 7" or a section name) and are underlined.Pass
Annotated screenshotsMarkers use shape and number as well as colour; numbered legends are real text.Pass
Known limitationWord version: screenshots carry alt text and the contents list is clickable, but page numbers in the contents are not generated.Open