# Enter scores (Judge's Companion)

> Judges use the mobile app to enter difficulty and execution scores during competition. Here's the full workflow for every role.

The Judges Companion app is how most scoring happens on competition day. Each judge gets the app on their phone or tablet, scans a QR code, and starts scoring. Scores flow to the leaderboard in real time.

## Prerequisites

* [Judge profiles are set up](https://docs.gymart.org/scoring/set-up-judge-profiles) and [assigned to apparatus](https://docs.gymart.org/scoring/assign-judges-to-apparatus)
* The Judges Companion app is installed on the judge's device (available on iPhone, Android, and in a web browser)

## Getting started

1. Open the Judges Companion app.
2. **Scan the QR code** the meet organizer provided. You can also log in manually if needed.
3. Select your **rotation** and **apparatus**.
4. Select your **judge role** (D1, E1 through E7, or S1).
5. Configure your preferences for score format, audio cues, and video settings.

You'll see the gymnast list for your rotation. You're ready to go.

## Entering scores

Tap a gymnast to open the score entry screen. What you see depends on your role.

**If you're a D1 (Difficulty Judge):** Enter the difficulty value based on element difficulty and connections. Add any neutral deductions for time or boundary violations. Add bonus values if applicable. The system calculates the start value from your entries.

**If you're an E judge (E1 through E7):** Enter your execution deductions from a 10.0 starting execution. The app shows the running execution score as you go. When multiple E judges score the same routine, the system removes the highest and lowest deductions automatically to calculate a trimmed mean.

**If you're an S1 (Supervisor):** You can fill any role at any apparatus. Select a rotation and apparatus, choose which role to score as, and follow that role's workflow. The S1 is typically used for overrides, corrections, or when a position is unfilled.

**If you're a VR (Video Recorder):** Select the gymnast, then use the app's recording feature to capture their routine. The video gets linked to the gymnast and apparatus automatically for later review. Video recording must be [enabled in the session configuration](https://docs.gymart.org/scheduling/create-a-session).

## Submitting

After entering all fields, tap **Submit**. You'll see a confirmation screen with the full score breakdown: final score, difficulty components, and execution deductions. Review it. If everything looks right, confirm. If you made a mistake, you can **revoke** the score and re-enter it.

Once an admin verifies the score, it's locked. You won't be able to change it after that.

## Second vault

For vault events with two attempts:

1. Enter and submit the first vault score as normal.
2. Tap **Add Second Vault** to enter the second attempt.
3. Enter the second vault's D and E scores, then submit.

Both vaults are tracked together. See [Handle vault scoring](https://docs.gymart.org/scoring/handle-vault-scoring) for how the system decides which score counts toward all-around.

## Score status after entry

| Status          | What it means                                   |
| --------------- | ----------------------------------------------- |
| **Not Started** | No score has been entered                       |
| **In Progress** | The judge started entering but hasn't submitted |
| **Submitted**   | The score is in and visible to the admin        |
| **In Review**   | The admin is checking the score for accuracy    |
| **Scratch**     | The gymnast did not compete                     |

## Visual guides

Detailed process diagrams for each judge role are available on Figma:

* [Scoring process overview](https://www.figma.com/board/5rj9atzlrbfoou0qzYpVl6/)
* [Difficulty judge flow](https://www.figma.com/board/8FZnfDuLmLyFEnT0U30Zmw/)
* [Execution judge flow](https://www.figma.com/board/VomIEoVwlay96cG7hkhn5Q/)
* [Video recorder flow](https://www.figma.com/board/CEWMnenpTff49plTvTKriF/)

## What's next

* [Understand score status](https://docs.gymart.org/scoring/understand-score-status)
* [Handle vault scoring](https://docs.gymart.org/scoring/handle-vault-scoring)

## Related

* [Enter scores from the admin interface](https://docs.gymart.org/scoring/enter-scores-admin)
* [How does scoring work?](https://docs.gymart.org/scoring/index)
* [Configure individual score settings](https://docs.gymart.org/levels/individual-score-settings)