Officials

Assign officials to matches

Invite officials to your organization, build each match's crew slate, assign people through the eligibility check, and close out their work after the match.

The Officials Assignment Board is where an organizer staffs league matches. You invite officials to your roster, set the crew slate each match needs (referees, scorer, timekeeper, and so on), and assign people to each slot. Officials answer from their own HustlX Officials inbox.

Organization owners, admins, and members with officials-management access. Your account must be verified. If Officials is missing from Manage, ask the organization owner to check your officials-management access and whether the board is enabled for the organization.

Before you start

Build your officials roster

Open your organization, select Manage, then Officials. The board has three tabs: Roster, Assignments, and History.

Invite an official

On Roster, select Invite official. In Official, search by name or email and select the right person. Add Notes (optional) if you want, then select Invite official. Wait for Invitation sent.

Wait for them to accept

The official accepts from Affiliations in their officials portal. Their status moves from Invited to Active. Only Active officials can be assigned, so invite people early.

Filter the roster by All, Active, Invited, or Suspended. Use the actions menu on a row to Suspend an official (they stay on the roster but cannot be assigned), Reinstate them, or Remove them. An official can only hold one open affiliation with your organization, so a duplicate invitation is blocked.

Staff a match

Find the match

Select Assignments to see upcoming matches that need a crew. Each row shows the teams, date, venue, league, and counts of needed, open, pending, and confirmed slots. Select a match to open Match crew.

Check the crew slate

HustlX prepares the crew slate from the match's sport. Each slot is a role with a number (for example two referee slots) and is marked Required or Optional.

If the match has no slots, select Configure crew slots, pick a Crew template (Basketball crew, Volleyball crew, or Badminton crew), turn each Required switch on or off, and select Save crew slots.

Pick an official

Select Pick official beside an open slot. Pick an official lists candidates checked against that slot and match:

  • Eligible: select Assign.
  • Override required: select Assign (with warnings). Read Override eligibility warnings?, then select Confirm and assign only if you accept the warnings. Cancel returns you without assigning.
  • Cannot assign: the button reads Blocked and cannot be selected.

Add a walk-in referee if needed

For a referee with no HustlX account, select Add a walk-in referee in the picker, enter the Referee name, and select Assign. Walk-ins are recorded as confirmed and get no notification. Only referee slots offer this.

The official receives the offer and accepts or declines it. Until they accept, the slot shows as pending.

Eligibility checks

ResultReasons
Cannot assignNot affiliated (no active affiliation with the organization that owns the league), or Time conflict (already assigned or confirmed on an overlapping match)
Override requiredNo availability set, Availability exception, Certification missing, No current certification record for this role and sport, Sport mismatch

Clean candidates are listed ahead of candidates with warnings. Nothing is assigned until you confirm the override dialog.

An override is recorded on the assignment. An assignment that carried eligibility warnings does not publish the official's match log as public proof, even after it is completed.

Track and change assignments

Each profile-linked assignment moves through Assigned, Confirmed, and then Completed or No show. While an assignment is still open you can:

  • Replace the official. The replacement goes through the same checks, and both officials are notified.
  • Cancel offer to pull the official off the match and free the slot. This is only available before the match starts.

Officials can decline an offer or withdraw from a confirmed assignment. Either way the slot opens again and your organization's admins are notified.

You cannot remove a slot while an assigned or confirmed official fills it. Replace or cancel that assignment first.

Completion and match-log proof

After the match starts, a confirmed slot shows Mark completed and Mark no-show.

  1. Select Mark completed, add Organizer notes if needed, and select Confirm completed. Or select Mark no-show, then Mark no-show to record that the official did not show.
  2. A completed assignment creates an official match log for that official, tied to the match, league, role, and sport.

The match log is published as public proof only when the match has concluded and the assignment carried no eligibility warnings. If you complete an assignment before the match concludes, HustlX publishes the log when it does. A no-show never publishes proof.

History lists past matches and their officiating crews.

Troubleshooting

Officials is not in my Manage menu

Your role needs officials-management access, and the board must be enabled for the organization. Ask the owner to check both.

The board shows a permission error

Your account lacks officials-management access, or your email is not verified.

I cannot assign a candidate

The candidate has a hard block: they are not an active member of your roster, or they already have an overlapping assignment.

A worked match is not showing as proof

Check that the match is concluded, the assignment was marked completed, and it did not carry an overridden warning.