---
title: "Assign officials to matches"
description: "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."
canonical_url: "https://docs.hustlx.com/officials/assignment-board"
---
# 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](https://docs.hustlx.com/officials/officials-guide) inbox.

<note title="Who can do this">

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.

</note>

## Before you start

- The officials you want need a HustlX official profile. See [Work as an official](https://docs.hustlx.com/officials/officials-guide).
- Schedule the matches first. See [Create and schedule matches](https://docs.hustlx.com/leagues/create-and-schedule-matches).
- Assigning officials is optional. A match can start without a crew.

## Build your officials roster

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

<steps level="3">

### 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.**

![Invite official dialog with the Official search and optional notes](https://docs.hustlx.com/screenshots/officials/assignment-board-invite.png)

### 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.

![Officials roster with an Active official, primary role, and certifications](https://docs.hustlx.com/screenshots/officials/assignment-board-roster.png)

</steps>

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

<steps level="3">

### 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**.

![Assignments tab listing an upcoming match with its crew progress](https://docs.hustlx.com/screenshots/officials/assignment-board-assignments.png)

### 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**.

![Match crew page with required roles, a filled referee slot, and Pick official buttons](https://docs.hustlx.com/screenshots/officials/assignment-board-match-crew.png)

### 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.

![Pick an official panel listing roster officials with their eligibility and assign buttons](https://docs.hustlx.com/screenshots/officials/assignment-board-picker.png)

### 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.

</steps>

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

## Eligibility checks

<table>
<thead>
  <tr>
    <th>
      Result
    </th>
    
    <th>
      Reasons
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      Cannot assign
    </td>
    
    <td>
      <strong>
        Not affiliated
      </strong>
      
       (no active affiliation with the organization that owns the league), or <strong>
        Time conflict
      </strong>
      
       (already assigned or confirmed on an overlapping match)
    </td>
  </tr>
  
  <tr>
    <td>
      Override required
    </td>
    
    <td>
      <strong>
        No availability set
      </strong>
      
      , <strong>
        Availability exception
      </strong>
      
      , <strong>
        Certification missing
      </strong>
      
      , <strong>
        No current certification record for this role and sport
      </strong>
      
      , <strong>
        Sport mismatch
      </strong>
    </td>
  </tr>
</tbody>
</table>

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

<warning>

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.

</warning>

## 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.

## Related guides

- [Match readiness](https://docs.hustlx.com/leagues/match-readiness)
- [Work as an official](https://docs.hustlx.com/officials/officials-guide)
- [Game Day overview](https://docs.hustlx.com/game-day/overview)
- [Create and schedule matches](https://docs.hustlx.com/leagues/create-and-schedule-matches)


## Sitemap

See the full [sitemap](https://docs.hustlx.com/sitemap.md) for all pages.
