> 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/meet-setup/custom-registration-fields.md).

# Add custom registration fields

> Collect extra details from clubs when they register gymnasts and coaches.

Sometimes the standard registration form doesn't capture everything you need. Custom fields let you ask each club for extra details as they register, such as a shirt size, a meal choice, or a medical note. Clubs answer them right in the registration form, and the answers travel with each gymnast or coach.

**Prerequisites:** You need to [create a meet](/meet-setup/create-a-meet.md) first.

## Add a field

From the meet admin, go to **Meet settings**, then open the **Additional fields** tab. You can keep separate fields for gymnasts and coaches, so pick the participant first.

Select **Add field**. The editor opens with the settings on the left and a live preview on the right.

1. Choose **Gymnast** or **Coach** at the top.
2. Give the field a **name**. This is the label clubs see, for example "Shirt size" or "Dietary restrictions". Each name has to be unique within the list.
3. Turn on **Required** if a club cannot submit the form without answering it. Leave it off for optional details.
4. Pick a **type** (see below).
5. Use the preview to try the field, then **Save**.

## Field types

The type controls what a club can enter and how the answer is checked.

* **Text** - A single line of free text. Good for names, notes, or anything open ended.
* **List of values** - A dropdown of options you define. Enter the options separated by commas, for example `Small, Medium, Large`. Clubs pick exactly one. Use this when you want consistent answers rather than free text.
* **Number** - A whole number. You can set a minimum and a maximum, for example a jersey number between 1 and 99.
* **Number with decimals** - A number that allows a decimal point, for example a height in metres. Minimum and maximum work the same way.
* **Yes / no** - A simple on or off choice.
* **Email** - A single email address, checked for a valid format.
* **Phone** - A phone number.

## Preview and test it

The preview on the right shows the field exactly as a registering club sees it. Fill it in and select **Test submit** to run the same checks a club will hit. If the value passes, you get a confirmation. If it fails, for example a required field left blank or a number outside your min and max, the error appears just as it would for a club.

Testing before you save is the quickest way to confirm the field behaves the way you expect, especially for lists and number ranges.

## What clubs experience

When a club registers a gymnast or a coach, your custom fields appear on their registration form under the standard details.

* Optional fields can be left blank.
* Required fields are marked and block submission until they are answered.
* List, number, and email fields reject entries that don't fit, so the data you collect stays clean.

You can add, edit, or remove fields at any time. Editing a field updates it for every club, so avoid changing a field's meaning after clubs have started registering.