> For the complete documentation index, see [llms.txt](https://docs.gymart.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gymart.org/settings-reference/judges-companion-settings.md).

# Judges Companion settings

These settings are configured in the Judge Setup screen, which opens when a judge taps the gear icon after selecting a rotation. Most are set once per session and can be changed mid-session by reopening the gear screen.

***

## Judge roles

### D1 (Difficulty judge)

**What it does.** Enables the difficulty score entry field for this device. The D1 judge evaluates the technical content of the routine and enters the difficulty value.

**What it affects.** The difficulty component of the final score. Without a D1 submission, the routine score is incomplete.

**When to use it.** Select D1 on the device assigned to the difficulty judge. In single-tablet mode, the secretary typically selects D1 alongside one or more E roles.

**Default.** Selected by default for all disciplines.

***

### E1 through E7 (Execution judges)

**What it does.** Enables execution score entry for this device. E1 through E7 each represent one judge's seat on the execution panel. The app enters each judge's mark separately and applies the appropriate trimmed mean when multiple E judges have submitted.

**What it affects.** The execution component of the final score. The number of active E roles determines how many submissions are expected before the score is ready to finalize.

**When to use it.** Each execution judge selects their assigned seat (E1, E2, and so on). In single-tablet mode, select all E roles the secretary is collecting. E7 is available for artistic disciplines only. Trampoline sessions support E1 through E6.

**Options.**

| Role | Use                                     |
| ---- | --------------------------------------- |
| E1   | First execution judge                   |
| E2   | Second execution judge                  |
| E3   | Third execution judge                   |
| E4   | Fourth execution judge                  |
| E5   | Fifth execution judge                   |
| E6   | Sixth execution judge                   |
| E7   | Seventh execution judge (artistic only) |

**Default.** E1 is selected by default for all disciplines.

***

### H1, H2 (Horizontal Displacement judges)

**What it does.** Enables horizontal displacement deduction entry. H1 and H2 each represent one HD judge who tracks how far the gymnast travels across the trampoline bed during a routine.

**What it affects.** The horizontal displacement component of the trampoline score. HD applies to individual trampoline and synchro trampoline; it is not present for double mini or tumbling.

**When to use it.** Select H1 or H2 on devices used at trampoline sessions. The default selection for trampoline includes both H1 and H2.

**Default.** H1 is selected by default for trampoline sessions; H2 is also selected by default for trampoline.

***

### VR (Video recorder)

**What it does.** Puts the device into video recording mode. The judge records each gymnast's routine on the device camera; recordings upload to the meet in the background.

**What it affects.** Video availability for review in the admin console after the session. Does not affect scoring.

**When to use it.** Assign VR to any judge or volunteer who is recording routines. On a mobile device, selecting VR reveals the audio recording toggle. On web, VR is available but the recording interface is adapted for that environment.

**Default.** Not selected by default.

***

### A1 through A6 (Artistry panel judges)

**What it does.** Enables artistry score entry for this device. The A1 through A6 roles each represent one seat on the artistry panel, which evaluates artistic presentation separately from execution. Used in rhythmic gymnastics, aerobic gymnastics, and acrobatic gymnastics.

**What it affects.** The artistry panel component of the score. Available artistry roles vary by discipline: rhythmic supports A1 through A4, while aerobic and acrobatic support A1 through A6.

**When to use it.** Select the artistry role matching the judge's assigned seat at RG, aerobic, or acrobatic sessions.

**Options.**

| Role | Use                                               |
| ---- | ------------------------------------------------- |
| A1   | First artistry judge                              |
| A2   | Second artistry judge                             |
| A3   | Third artistry judge                              |
| A4   | Fourth artistry judge                             |
| A5   | Fifth artistry judge (aerobic and acrobatic only) |
| A6   | Sixth artistry judge (aerobic and acrobatic only) |

**Default.** Not selected by default.

***

### TV1 through TV4 (Technical Value panel, AGG)

**What it does.** Enables Technical Value panel entry for Aesthetic Group Gymnastics. Each TV role represents one judge on the panel that evaluates technical difficulty and content.

**What it affects.** The Technical Value component of the AGG score.

**When to use it.** Select the TV role matching the judge's assigned seat at AGG sessions.

**Default.** TV1 is selected by default for AGG sessions.

***

### AV1 through AV4 (Artistic Value panel, AGG)

**What it does.** Enables Artistic Value panel entry for AGG. Each AV role represents one judge on the panel that evaluates artistry and choreography.

**What it affects.** The Artistic Value component of the AGG score.

**When to use it.** Select the AV role matching the judge's assigned seat at AGG sessions.

**Default.** Not selected by default.

***

### EX1 through EX4 (Execution panel, AGG)

**What it does.** Enables Execution panel entry for AGG. Each EX role represents one judge on the panel that evaluates execution quality.

**What it affects.** The Execution component of the AGG score.

**When to use it.** Select the EX role matching the judge's assigned seat at AGG sessions.

**Default.** Not selected by default.

***

## Scoring settings

### Score Format

**What it does.** Controls how the difficulty field is labeled and calculated. Start Value means the judge enters the combined start value, which already includes bonuses. D-Score means the judge enters raw difficulty separately from any bonus.

**What it affects.** The label shown on the difficulty entry field and how the confirmation screen breaks down the score. The underlying math differs: Start Value mode folds bonuses into the single SV field; D-Score mode keeps raw difficulty and bonus entries separate.

**When to use it.** Match this to the competition's code. Use Start Value for most club and national competitions. Use D-Score for FIG competitions where difficulty and bonus are reported separately. For FIG sessions this is fixed to D-Score and the toggle is not shown.

**Options.**

| Option      | What it means                                               |
| ----------- | ----------------------------------------------------------- |
| Start Value | Judge enters the combined start value including bonuses     |
| D-Score     | Judge enters raw difficulty; bonuses are entered separately |

**Default.** Start Value

***

### Score Entry Mode

**What it does.** Controls how execution judges enter their mark. Final Score means the judge types the mark directly. Deductions means the judge enters the deduction from 10.0, and the app computes the resulting mark.

**What it affects.** The execution entry field. In Deductions mode with multiple E judges, the app applies a trimmed mean across their individual deductions before computing the execution score. This toggle is only visible when at least one E role is selected. It does not appear for trampoline sessions, which always use deductions.

**When to use it.** Use Final Score for club competitions where judges write down a mark directly. Use Deductions for FIG-style competitions where judges record what they take away. For FIG sessions this is fixed to Deductions and the toggle is not shown.

**Options.**

| Option      | What it means                                            |
| ----------- | -------------------------------------------------------- |
| Final Score | Judge enters the execution mark directly                 |
| Deductions  | Judge enters deductions from 10.0; app computes the mark |

**Default.** Final Score

***

### D-Score Entry Method

**What it does.** Switches how the D judge inputs the difficulty value. Keypad presents a numeric keypad. Table presents a skill lookup picker.

**What it affects.** The entry widget shown to the D judge at score entry time. The stored value is identical either way.

**When to use it.** Use Keypad for most competitions. Use Table at sessions that follow a skill-table workflow where the D judge selects elements from a list rather than typing a total.

**Options.**

| Option | What it means                                   |
| ------ | ----------------------------------------------- |
| Keypad | Numeric keypad for direct difficulty entry      |
| Table  | Skill picker for element-based difficulty entry |

**Default.** Keypad

***

### Single judge (one tablet)

**What it does.** Tells the app that all judging roles on this device are the only source of scores for each gymnast. The score is ready to submit as soon as all selected fields are filled, without waiting for other devices to contribute.

**What it affects.** When to enable the Submit button. With Single judge on, the button activates as soon as this device's fields are complete. With it off, the app waits for other devices (in multi-judge mode) to submit their partial scores before the overall score is finalized.

**When to use it.** Turn on for secretary or single-tablet judging, where one device collects all scores. Turn off when each judge is on a separate device and submits independently.

**Default.** On

***

## Session judge setup

These are set by the organizer in the session's settings in Gym Art Meets, not on the judge's device. They decide what the Judges Companion presents for the session.

### FIG session

**What it does.** Marks the session as following FIG rules and turns on FIG judge assignment and rotation configuration.

**What it affects.** When on, the session uses the FIG scoring shape: the score format is fixed to D-Score and the entry mode to Deductions, and those selectors are disabled. It also enables the per-apparatus judge assignment and rotation configuration tools.

**When to use it.** Turn it on for competitions judged under FIG rules with a full judging panel. Leave it off for club and national formats where you set the score format and entry mode yourself.

**Default.** Off.

***

### Default judge roles

**What it does.** Sets which roles are pre-selected for each apparatus when a judge signs in.

**What it affects.** When a judge opens the session in the Judges Companion, the roles set here are already selected for their apparatus, so they can start scoring faster. Judges can still change their selection. This is turned off for FIG sessions, which assign roles through rotation configuration instead.

**When to use it.** Set the roles your panel uses on each apparatus, for example D1 and E1 for a small panel.

**Default.** D1 and E1 for most disciplines; trampoline adds the horizontal displacement roles.

***

### Artistry deduction

**What it does.** Shows a separate artistry deduction field in score entry.

**What it affects.** When on, execution judges enter an artistry deduction that is folded into the execution total. Applies to artistic disciplines.

**When to use it.** Turn it on for events where artistry is judged separately, such as WAG floor and beam. Leave it off where artistry is not scored on its own.

**Default.** Off.

***

## Video settings

### Include audio

**What it does.** Enables the device microphone when recording routines. When on, the recording captures crowd and coaching audio alongside the video.

**What it affects.** Whether the uploaded video file includes an audio track. Only visible when the VR role is selected.

**When to use it.** Turn off in venues where ambient audio is distracting or where privacy is a concern. Turn on when the audio track is useful for replay review.

**Default.** Off

***

### Auto-upload videos

**What it does.** Uploads completed recordings to the meet automatically in the background as soon as each routine finishes. When off, recordings queue on the device and upload only when the judge manually triggers the upload.

**What it affects.** How quickly videos are available for review in the admin console. In a low-bandwidth venue, disabling auto-upload avoids competing with score traffic during the session.

**When to use it.** Leave on unless bandwidth is limited. Turn off in venues with poor Wi-Fi, then trigger the upload manually at a break.

**Default.** On

***

## Score entry concepts

### Start Value Bonus

A bonus added to the difficulty score to form the Start Value. It covers things like connection bonuses and dismount bonuses depending on the competition code. The judge enters it as part of the difficulty section. It is included in the Start Value shown on the scoreboard.

The Start Value Bonus field appears only when the organizer has enabled it for the session.

### Final Score Bonus

A bonus applied after all other calculations are complete. On vault, it is applied after the two-vault average or best-of calculation. The judge enters it in the difficulty section and it is shown separately in the score breakdown.

The Final Score Bonus field appears only when the organizer has enabled it for the session.

### Vault: two scores per gymnast

At vault events where gymnasts compete two vaults, each gymnast's tile shows two rows in the gymnast list, one for each vault. You score them independently. The calculation that combines them (average, best, or first vault only) is set by the organizer at the level and is shown to you in the score confirmation screen.

For full details, see [Enter two vault scores](/judges-companion/index/enter-two-vault-scores.md).

***

## Related

* [Judges Companion overview](/judges-companion/index.md)
* [Configure judge roles](/judges-companion/index/configure-judge-roles.md)
* [Score entry modes](/judges-companion/index/score-entry-modes.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/settings-reference/judges-companion-settings.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.