tabminton Guides Download
Browse guide chapters

Troubleshooting

Use this chapter to locate the level at which data or an action is missing. Start with context and filters, then inspect saved dependencies before changing or deleting anything.

Start with the current context

  1. Check whether the amber Demo badge is visible. Normal and Demo mode use separate tournaments, players, pairs, and venues. Leave Settings after changing Demo mode so the rest of the app reloads the correct data set.
  2. Return to the dashboard and open the intended tournament. Tournament screens always use the currently open tournament.
  3. Check the selected event, phase, and draw. On screens with several tabs, a valid record in another tab can look missing.
  4. Check the selected Date. Planner shows assignments on their saved date. Match day includes a match when its scheduled time, actual start, or actual end belongs to the selected date.
  5. Clear filters and search. Reapply them one at a time after the record appears.
  6. Distinguish a virtual match in Draft from an actual match. A format plan and Draft assignment do not create a match that can be scheduled, started, scored, or published. Generate actual matches on Draws.
  7. If data changed on another screen, leave and reopen the screen you are checking. Some screens load a local view when opened and do not share one automatic refresh mechanism.

When something is still missing, trace it in this order: global player or pair, tournament registration, event entry, draw membership, actual match, Planner assignment, Match day card, saved result, and published snapshot. At each level, check status and downstream dependencies before changing saved data.

A player or pair is missing

Trace participation as global record → tournament registration → Accepted → pair when needed → event entry. Acceptance is not event membership, and an event entry is not draw membership.

A player is missing from Add Players

Check Normal or Demo mode first. Then check the global Players registry. Add Players shows global players who do not already have a registration in the open tournament, so also clear its search and inspect the existing registration list.

An accepted player is missing from available singles entries

Confirm that the registration is Accepted, the player has a gender, and the selected singles event matches that gender. Then check whether the player already has an entry in this event or is already used by another entry in the same event.

A player is missing from an event or pair selector

Check the player’s global record, tournament registration, Accepted status, gender, and the selected event category. Pair and event selectors can also exclude a player who is already used by another selected or saved entry in that event.

A pair is missing on Entries

Open global Doubles and confirm that the pair exists. Both players must have Accepted registrations and the pair must fit the selected event category. The pair is excluded when it is already entered, or when either player is already part of another entry in the same event.

Another entry already uses the player or pair

Inspect all entries in the selected event. One player cannot belong to multiple entries in that event, including through two overlapping pairs. Remove an accidental event entry only after checking its draw membership, matches, schedule, results, and playoff dependencies.

A rejected or removed registration still competes

Changing or removing a registration does not remove saved entries, draw assignments, matches, schedule assignments, or results. Review those competition records separately and preserve the intended history. Do not assume that changing the registration repaired downstream data.

Normal data disappeared after enabling Demo mode

Demo mode hides normal records; it does not delete them. Open Settings, turn off Demo mode, leave Settings, and reopen the required tournament.

For the complete participation workflow, see Manage players and registrations, Manage entries and pairs, and Use Demo mode.

An entry cannot be added, changed, seeded, or removed

Add Entry has no candidates

Confirm that the event exists and that the intended players have Accepted registrations. Check gender and category compatibility, then check whether the player or pair already has an entry or overlaps another entry in the same event. The event age rule is checked later when an entry enters a draw, not in Add Entry.

An entry cannot be added or changed

Check the selected event and its existing entries first. A player can enter different events but cannot appear in two entries of one event. For doubles, both players must be accepted and compatible with the category. If the entry already exists, edit the existing participation record instead of trying to add a duplicate.

A declared seed cannot be changed

Check whether the event already has generated matches. Seed controls remain visible, but saving or clearing declared seeds is blocked after any match exists for the event. Review the draws and consequences before considering match deletion.

An entry cannot be removed safely

Remove can leave draw membership, standings, matches, schedule assignments, and results that still refer to the old participation. Before removing, inspect every draw and match for the event. If competition has started, preserve the record or use the documented Swap workflow only after reviewing its effects.

Swap or removal happened after draws were created

Reopen Draws, Planner, Standings, and completed results. Swap updates existing competition records but keeps saved times and courts; it can also reattribute completed history. Plain removal does not clean the downstream records. Verify every affected side before play continues.

Demo Seed entries fails in Group mode

The demo command Seed entries → Group has a known non-atomic limit when Top-N is greater than 2. It can save exact seeds 1 and 2 before reporting an error. Inspect the saved seeds before correcting them or running the command again.

See Manage entries, swaps, and seeding and Use Demo mode commands for the complete procedures.

A draw or playoff cannot be created or changed

An entry is missing from Unassigned

Confirm that it is an event entry, then inspect every visible draw in the selected phase. An entry assigned to another group in that phase is removed from Unassigned. Draw membership is separate in other phases.

A phase kind cannot be changed or the phase cannot be deleted

A phase kind can change only while the phase has no draws or virtual tables. A phase can be deleted only under the same condition. Check Draws and Edit phase → Virtual tables, then remove dependencies in competition order.

Clear Groups is blocked

At least one visible group has generated matches. First inspect its schedule, results, standings, and playoff sources. Delete matches only when losing those match records is intended; then return to Lineups and clear the groups.

Generate Matches is unavailable

The round-robin draw needs at least two entries in its lineup. Add the missing draw member on Lineups. An event entry that remains in Unassigned is not part of the group.

Generate Bracket fails

Check that the lineup has at least two entries and that the draw has no existing matches. Then check exact and grouped seeds against the actual entry count and derived bracket size. For an empty bracket, use Manual assignments; do not rely on Fill bracket as a recovery action.

A source draw is missing from the selector

The source must be an eligible group or virtual table in an earlier phase of the same event. Unphased, same-phase, later-phase, other-event, and playoff draws are not offered.

A source draw or virtual table cannot be deleted

Saved playoff positions still reference it. Inspect the destination bracket, clear the relevant saved positions with Manual → Apply or reset the consumer bracket when safe, and only then remove the source. A virtual table is removed through Edit phase → Virtual tables.

The playoff lineup and Size disagree

The lineup controls do not enforce Size. Generate Bracket uses the actual lineup, while Generate empty bracket uses Size. Resolve the intended capacity before matches exist; adding or removing lineup entries later does not rebuild the bracket.

A draw cannot be deleted

Separate the two blockers. Generated matches block deletion of the draw itself, while saved downstream source references block deletion even when the source draw is empty. Review both match records and consumer playoff positions before removing either dependency.

Delete draw did not appear after deleting matches

Leave and reopen Draws, expand the draw again, and check Delete draw. The outer draw list can retain its previous match count until the screen is reopened.

The lineup changed after matches were created

Existing matches are not rebuilt when lineup controls remain usable. Stop scheduling or entering results, compare the lineup with every generated side, and decide whether the saved matches must be preserved or deliberately reset. See Build draws and playoff brackets and Progress qualifiers.

A match is missing or cannot be scheduled

Format or Draft shows the match, but Planner does not

Format defines planned structure and Draft places virtual matches. Neither creates actual match records. Create the actual draw and generate its matches on Draws, then open Planner.

An expected match is absent after generation

Check the selected event, phase, and draw on Draws → Matches. An odd round-robin lineup has a bye tour with no match record. A playoff bye can become an automatic Walkover, which is excluded from some operational and report lists.

A match is missing from Unscheduled

Clear Event, Round, and Stage filters. The match may already be assigned on another date, may have a status outside the list such as Walkover, or may have been replaced when draw matches were rebuilt.

An assigned match is missing from the grid

Select its saved date. If Day Settings changed, the assignment can be off-grid, outside visible slots, or hidden beneath another assignment in the same visual cell. Changing the grid does not change the saved assignment.

There are no courts or complete time slots

Add courts on Overview. Check the selected date’s Start and Duration in Day Settings; at least one complete slot must fit between Start and midnight.

A target cell is occupied or a card cannot move

Choose a free cell. Normal dragging is available only for Scheduled and Ready cards. A different status keeps its saved assignment and must be resolved through the appropriate match workflow.

Bulk placement completes only partly

The assignments that fit remain saved, and the remainder stays in Unscheduled. Inspect the grid and the remaining selection before retrying from an earlier free cell or another date.

See Plan virtual matches in Draft, Generate actual matches, and Schedule matches in Planner.

A Match day card is missing, blocked, or cannot start

A scheduled card is missing

Check the selected Date. A card belongs to a date when its scheduled time, actual start, or actual end is on that date. If all three are empty, assign the match in Planner. Also check whether rebuilding the draw deleted the old match record.

A card shows Ready, Rest, Waiting, or Blocked

Ready means both sides are known and the effective not-before time has passed. Rest reflects a future soft not-before value. Waiting includes other not-ready cases, such as an unknown side or a future hard limit. The Blocked filter covers a live-player conflict or current player unavailability.

These queue labels are operational guidance, not identical start rules. A Rest or Waiting badge, a hard or soft not-before value, and player unavailable-until guidance do not by themselves block Start Match. Check the actual start control and any error it reports.

A card cannot start

Confirm that both sides are known. Then check for a player already in another Live match, an occupied court, and the availability of any configured court. The final court and player checks cover the tournament even when the selected-date queue does not show the conflicting live card.

A player is unavailable until a future time

The saved unavailable-until value contributes to soft not-before guidance and the Blocked filter. It is stored for the current calendar day, not an arbitrary selected Match day date. Review the warning before deciding whether the match may start.

Counters do not match the visible cards

Clear the queue filters. The overall Blocked metric counts all not-ready Scheduled and Ready matches, including Rest, Waiting, and unknown sides, while the Blocked filter counts live-player conflicts and current unavailability. The selected date also limits the cards in view.

See Run the tournament on Match day for court, queue, unavailability, and start procedures.

A result or winner cannot be saved or corrected

Save Result reports an invalid set

For Finished, fill both scores, use the tournament’s Points per set and Best of, keep the required lead or valid capped deuce score, and remove sets entered after the match was decided.

A winner is missing or wrong

For Finished, the winner comes from valid sets and cannot be selected separately. Walkover and Retired require a selected winner; Walkover stores no sets, while Retired can retain partial scores without normal set validation.

A group result is locked

Locked round-robin standings prevent result edits. Inspect the qualifiers and downstream playoff matches before using the safe unlock procedure. Unlock only while no resolved qualifier feeds a started or completed dependent match.

A playoff winner cannot be changed

The immediately dependent match already has a completed result. Review the full downstream path first. The result form does not automatically reset that later result, although a score-only correction that preserves the winner can still be saved.

A completed result cannot be found

Use Draws → Matches to correct results. Match results is read-only and includes only completed non-bye matches with a scheduled time. Clear its filters and search, but use the draw when an unscheduled completed match or automatic bye must be checked.

See Record and correct match results and Unlock standings safely.

A qualifier does not reach the playoff

  1. Confirm that every group match is Finished, Walkover, or Retired.
  2. Confirm that the source standings or virtual table is locked. A virtual table waits until every group in its phase is locked.
  3. Inspect the destination playoff bracket and confirm that a saved source reference points to the required place.
  4. Select Push to playoff. Locking a table does not push automatically.
  5. Check that the required place exists and that another concrete entry does not occupy the destination slot.
  6. Check whether the destination or downstream match is Live, Finished, or Retired; started competition can block replacement or safe unlock.
  7. If standings were reordered manually, use the safe unlock, relock, reorder, and repush sequence before dependent matches start. Reordering alone does not replace a qualifier already pushed.

See Lock standings and progress qualifiers for the complete dependency checks.

A court, event, phase, draw, or tournament cannot be deleted

A court cannot be deleted

Check every match for an assignment to that court, including past and future dates. Move or remove only the intended assignments first. A court used by at least one match cannot be deleted.

An event cannot be deleted

Inspect its entries, draws, matches, standings, and other dependent competition data. Remove those records in downstream-to-upstream order only when their loss is intended, then retry the event deletion.

A phase cannot be deleted

Remove every draw and virtual table from the phase first. Before removing them, clear matches and playoff source references in their consumers as described in the draw troubleshooting section.

A draw cannot be deleted

Check for generated matches and for saved references from downstream playoff positions. Delete or reset matches only after reviewing schedule and results, then clear consumer source references before deleting the draw.

A tournament cannot be deleted

An Accepted registration disables deletion. Review registration statuses first. If deletion becomes available, remember that the confirmed action removes the tournament and its remaining dependent data; the app does not offer a rollback.

A global player or pair is about to be deleted

Stop and inspect tournament registrations, pair membership, entries, draw membership, matches, results, and points. Deleting a global player can remove registrations and pair membership. Deleting a global pair can remove event entries and draw assignments and can leave existing match sides empty. There is no dependency preview or rollback in the app.

See Manage global players and pairs, Configure courts and events, and Build draws.

Publishing does not work

  1. Check that Publish token in Settings is present and current. An empty token disables Publish and Auto; an incorrect non-empty token is rejected when publishing.
  2. For Auto, make one successful manual publication from Match day to create the local baseline, select Auto, and confirm that the +N badge is above zero.
  3. Allow at least one minute after the latest successful publication or automatic attempt. A failed automatic attempt also starts this interval.
  4. If +N stays at zero, check what changed. The comparison covers match status, sides, winner, and set scores, not every publishable field. Publish manually for changes outside that scope.
  5. For a timeout, network error, or server error, keep working locally and retry manually when the connection or service is available. A failure does not roll back local tournament work.
  6. After a success response, open the public link separately. The displayed publication time and local baseline are not a live check of the public page.

See Publish a tournament snapshot for token setup, complete badge scope, error handling, and public verification.

A report or printed page is incomplete

  1. Clear report filters and reopen the required report from Reports to refresh its screen snapshot.
  2. For Matches list, check selected events and dates. Unscheduled appears only when all available scheduled dates are selected and an eligible unscheduled match exists.
  3. For Statistics, remember that unscheduled matches are excluded. Its counts intentionally differ from a Matches list that includes eligible unscheduled matches.
  4. For Participants list, check Accepted registrations and actual event entries separately. Acceptance includes a player in the complete list; a specific event filter requires an entry in that event.
  5. Use the system print dialog and inspect its preview, paper size, scale, margins, wrapping, and page count. PDF availability depends on the operating system print options.

See Create and print reports for each report’s complete scope.

Know when to stop and review dependencies

Stop before deleting or regenerating matches, resetting a playoff bracket, changing a lineup after matches exist, unlocking standings, deleting a global player or pair, or repeating a bulk action that may have completed partly.

Before continuing, inspect the part already completed and compare draw membership, saved matches, Planner assignments, Match day state, results, standings, and downstream playoff data. Match deletion and bracket reset remove schedule and result records. Lineup edits do not rebuild existing matches. Unlocking can clear pushed qualifiers. Non-atomic bulk actions can leave valid saved work that a blind retry would duplicate or conflict with.