# 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](/scoring/set-up-judge-profiles.md) and [assigned to apparatus](/scoring/assign-judges-to-apparatus.md)
* 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](/scheduling/create-a-session.md).

## 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](/scoring/handle-vault-scoring.md) 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](/scoring/understand-score-status.md)
* [Handle vault scoring](/scoring/handle-vault-scoring.md)

## Related

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gymart.org/scoring/enter-scores-judges-companion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.