What an attendance mark has to mean before you can count anything
In short
An attendance mark is not a boolean. It is a value from a controlled vocabulary of about 9 states, carrying who set it, when, and what it replaced — because the same physical fact, an empty spot on the pitch, means five different things commercially and every one of them settles differently against a paid entitlement.
Key takeaways
- Not-on-the-pitch has at least 5 distinct meanings, and each settles differently against a paid entitlement.
- The author is part of the mark. A coach may not grant an excusal; a door scan may only ever propose presence.
- Cancelled-by-club is a system-set mark and must never read as an absence in any report.
- Registers are corrected 2 to 4 days later, so marks must be append-only with a reason on every amendment.
- A register records which adults were with which children, which makes it evidence before it is a report.
- Every attendance number a club quotes depends on this vocabulary being fixed first.
A tick box cannot answer a single question a club actually asks. Did this player train often enough to be selected? Did the parent receive the 10 sessions they paid for? Which adult was supervising a 14-year-old at 18:30 last Tuesday? All three need the same thing: a mark that carries a meaning, an author and a history, rather than a true or a false.
The difficulty is that one observation — the person is not here — covers several commercially distinct situations. A member who cancelled in time, a member who did not turn up, a player excused for an exam, an injured athlete on the touchline and a session the club called off all look identical from the pitch, and settle completely differently.
The mark set, and what each one settles
| Mark | Who may set it | Counts against the entitlement? | In the development record? |
|---|---|---|---|
| Present | Coach; proposed by check-in | Yes | Yes |
| Late | Coach only, with an arrival time | Yes | Yes, with minutes missed |
| Absent, unnotified | Coach, or the system at session close | Yes | Yes, as an absence |
| Absent, notified in time | Member or parent before the cut-off | Per your stated policy — decide it once | Yes, as a notified absence |
| Excused | Admin only | No | Yes, neutral |
| Injured, observing | Coach, with a linked injury note | Usually not | Yes — continuity matters for selection |
| Trialist | Admin at booking, coach confirms | No entitlement exists yet | Held separately until conversion |
| Make-up attendee | System on grant, coach confirms | Consumes the original credit only | Yes |
| Cancelled by club | System only, never a coach | No, and any consumed credit returns | Not an absence, and must never render as one |
The last row is built wrong most often. A session the club cancelled is not an absence by anybody, and if it renders as one, a player's attendance percentage drops because a pitch flooded. Cancelled sessions leave both the numerator and the denominator — the same argument that governs facility reporting in court utilisation and the denominator that hides.
The author is part of the mark
Who set a mark determines what it means, so store it and enforce it. Three rules cover most of the risk.
- A coach may record what happened, not what it costs. Present, late, absent and injured are observations. Excused is an entitlement decision, and letting a coach grant one at the side of a pitch turns goodwill into unbilled sessions nobody reconciles.
- A parent or member may notify, not attend. A member-set mark is a notification of intent that the register still has to confirm, because people cancel and then turn up.
- Hardware proposes, it never decides. A scan at the door is evidence somebody entered a building, not that they took part in the session — and it can be the wrong somebody, which is a separate fault diagnosed in lapsed members still getting through the door.
The amendment trail, because registers are corrected later
Coaches fix registers 2 to 4 days after the session, from memory, usually on a Sunday evening. That is normal behaviour and the model has to accommodate it rather than pretend otherwise.
- Never update a mark in place. Write a new row carrying the new value, the author, the timestamp and the value it supersedes, so the register at any past moment is reconstructable.
- Require a reason beyond a short window. A coach may amend freely for 7 days; after that an amendment needs an administrator and a typed reason. Without a boundary, a register becomes editable history.
- Stamp downstream artefacts with the version they read. If billing consumed a credit on Tuesday's version and the mark changed on Friday, the invoice has to be able to say which one it used.
- Alert on late bulk edits. One coach amending 40 marks at once, a fortnight after the fact, is either a system that failed on the night or a register being reconstructed rather than corrected.
Once the vocabulary is fixed, the reports become arithmetic rather than argument. Attended over scheduled, per venue and per coach, tells you which sessions earned their slot next term — the planning problem worked through in one term timetable across three venues. Without it, every one of those numbers changes depending on who ran the query.
This is schema work, not analytics: 9 values, an author, a timestamp and an append-only history. It is the foundation everything else in scheduling, attendance and the facility is built on, and it is normal MVP and product build groundwork inside our sports and fitness practice. Capturing the mark on a device in a basement with no signal is a different problem, and it is a harder one.
Frequently asked questions
Short answers to the follow-ups this page tends to raise.
Is a check-in scan the same as an attendance mark?
No. A scan proves somebody passed a door; a mark states that a named person took part in a named session. Treat the scan as a proposal the register confirms, because people scan in and leave, scan a friend through, or train without ever passing the reader. Clubs that equate the two end up with attendance figures that are really footfall figures.
Should a coach be able to change a register after the session?
Yes, within a bounded window and with the change recorded. Coaches routinely correct registers 2 to 4 days later and the alternative is registers that are simply wrong. Allow free amendment for about a week, require an administrator and a reason after that, and store every version rather than overwriting the mark.
Does a notified absence use up a class-pack credit?
That is a policy decision the system must be told explicitly, not a technical default. Either way, the mark must distinguish notified from unnotified absence, because the two are indistinguishable on the pitch and completely different at the till. Decide it once and enforce it in code rather than at the reception desk.
How should a trialist appear on a register?
As a first-class attendee with a trialist mark, not as a member stub or a scribble in the notes. A trialist consumes a place, needs a guardian consent record if under 18, and must appear in the safeguarding record for that session — none of which works if they exist only as a name a coach typed. Convert the record on joining rather than recreating it.
- attendance
- registers
- data model
- academies
The work behind this page
Builds from our portfolio that this page draws on.
FieldRoute
An AI field-service platform that auto-dispatches the best-matched technician, optimizes routes, and tracks first-time-fix against every SLA.
OperationsDockQueue
A dock scheduling and yard management platform that lets carriers self-book dock appointments, assigns the right door on arrival, and tracks every trailer's dwell and detention live.
LogisticsRead next
- A session series is not eighteen sessions: the recurrence record explainedA series is a rule plus an exception list, not a pile of rows. Every confusing this-event-or-all-events prompt comes from that one storage decision.definition
- Court utilisation is a fraction, and the denominator is the argumentBooked, attended and revenue-bearing over available: three honest utilisation numbers for one week, and the denominator argument that decides all three.definition
- Full class, empty floor: where waitlist promotion silently failsThe spot is released, offered and accepted on a clock that runs out before anyone could reach the building. Instrument four timestamps for one week and the cause names itself.diagnostic
- Lapsed members are still getting through the doorThe door holds its own copy of who may enter. That makes revocation a push you have to design, and puts the fault in the timing and direction of that push rather than in your membership data.diagnostic
- A guardian is not a member: the account type most club software lacksMost club systems model a parent as a member who happens to have children attached. That works until a household disagrees about who may do what, which happens constantly.definition
- Freeze, pause, hold: three words, three different billing outcomesA freeze moves dates. Which dates — the next collection, the agreement end, or both — is a product decision most clubs never wrote down, and every freeze argument starts there.definition
Working on something in this space?
Tell us where you are in a sentence or two. We'll tell you honestly whether we're the right team, and what a sensible first slice of the work looks like.
Start the conversation