Statistics & Standings

4league automatically computes standings, leaderboards, and disciplinary records from confirmed match events. This page describes exactly what is aggregated across a competition, what is recorded only per match, and what is not tracked at all — so coaches, organizers, and fans know which numbers the app can answer and which it cannot.

League Standings

The standings table is the central view of any competition. It ranks teams by points and is updated every time a match result is confirmed.

Points System

The default points system awards:

• 3 points for a win
• 1 point for a draw
• 0 points for a loss

Organizers can customise the points system from competition settings — for example, some competitions use 2 points for a win, and competitions that allow drawn matches to be resolved by penalties can award separate point values to the shoot-out winner and loser.

Tiebreakers

Two different tiebreaker systems exist in 4league, depending on where the ranking is being computed.

Per-competition tiebreakers

Each competition can define its own ordered ranking array from competition settings. The available criteria are:

• points — total league points
• matchesPlayed — number of matches played
• pointsDirectMatches — head-to-head points between the tied teams
• goalDifference — goals scored minus goals conceded
• goalScored — total goals scored
• redCards — fewer red cards ranks higher
• yellowCards — fewer yellow cards ranks higher
• order — manual ordering set by the organizer

When a competition does not define a custom ranking array, 4league falls back to a hardcoded order. Teams are compared in this sequence, the first non-equal criterion wins:

1. Knockout / playoff bracket position (inPlayoff)
2. Whether the team is in the final (isFinal)
3. Points
4. Matches played
5. Goal difference (goals scored minus goals conceded)
6. Goals scored
7. Head-to-head points between the tied teams
8. Red cards (fewer is better)
9. Yellow cards (fewer is better)
10. Manual order set by the organizer
11. Team key as a final, deterministic fallback

Organization-level tiebreakers

When teams are ranked across competitions inside an organization's ranking, a different, simpler set of tiebreakers applies. The valid values are headToHead, goalDifference, goalsFor, totalWins, and alphabetical. Two preset orders ship with the app:

• Local / regional templates — headToHead → goalDifference → goalsFor → totalWins → alphabetical
• National / international templates — headToHead → goalDifference → totalWins → goalsFor → alphabetical

Group Standings

Competitions using a group stage format display separate standings tables for each group. 4league handles up to 8 groups simultaneously, each with independent points and tiebreakers.

Example Standings Table

Every column shown below is computed and persisted per team for each competition: P from playedMatches, W/D/L from wins/draw/lost, GF and GA from goals made and goals received, GD as their difference, and Pts as the running league points total. Yellow and red card totals are also aggregated per team — they do not appear in the default table view but are used as tiebreakers and feed the discipline ranking below.

P = Played, W = Won, D = Drawn, L = Lost, GF = Goals For, GA = Goals Against, GD = Goal Difference, Pts = Points

Aggregated Leaderboards

Beyond the main table, 4league rolls up several competition-wide leaderboards from confirmed match events.

• Top scorers — players ranked by total goals scored in the competition.
• Top assistants — players ranked by total assists.
• Cards aggregate — total yellow and red cards across the competition, plus the single player with the most cards (mostCards, sorted first by reds then by yellows).
• Best defence — the team with the lowest goals-conceded-per-match ratio. To qualify a team must have played at least ceil(maxPlayedMatches × 0.5) matches, so a team with one strong defensive game early in the season cannot top the list.
• Best shape (form) — computed from each team's last 5 results. Recent results are weighted more heavily than older ones, so a win in the most recent match scores higher than the same win five matches ago. Goal difference, then goals scored, then points break ties.
• Man of the Match — awarded once per match (not aggregated across the season). If the competition's voteSettings.minimumVotes threshold is met, the fan vote (Votes collection) wins. If the threshold is not met, 4league falls back to the top scorer of the winning team; for a drawn match it uses the top scorer or top assister across both teams (whichever has the higher count). Organizers and match owners may also pick MOTM manually.

Top Scorers

The top scorers table ranks all players in the competition by goals scored in the current season. It updates automatically whenever a goal event is confirmed in a match. The same goal events also feed the top assistants list described above.

Example Top Scorers Table

Cards Statistics

Player Cards Ranking

The discipline table ranks players by total cards received, sorting first by red cards and then by yellow cards. This is useful for coaches reviewing their squad's behaviour and for organizers enforcing suspension thresholds.

Team Disciplinary Record

Each team has an aggregated disciplinary record showing total yellow cards and total red cards across the competition. These totals are also wired into the standings tiebreakers (fewer red cards, then fewer yellows, ranks higher). Organizers can use this data to award fair play trophies at the end of the season.

Team Statistics

Each team's profile within a competition shows a detailed statistical breakdown for the current season, derived from the aggregated standings row.

Per-Match Stats (Not Aggregated)

Some statistics are recorded against an individual match document but never rolled up into competition-level totals. You will see them on a finished match's detail page, but they do not appear in the standings, the team profile, or any leaderboard.

• Ball possession — saved live during the match and stored as a two-value array on the match (e.g. [58, 42]).
• Shots — total shots per team in that match.
• Shots on target — subset of shots that were on target.
• Fouls — total fouls per team in that match.

Because these fields live on the match document only, the app cannot answer questions like “which team has the most shots this season?” or “average possession across the competition” — the data is not aggregated.

What 4league Does Not Track

For accuracy, the following statistics that are common in professional football data feeds are not recorded anywhere in 4league:

• Offsides — no field exists at the match or team level.
• Corners — no field exists at the match or team level.

If a feature, dashboard, or export appears to show one of these values, treat it as out of scope — the underlying number is not collected.

Player Statistics

Every player in a competition has an individual statistics page showing their contribution to the season. Statistics are accumulated automatically as match events are entered.