Athlete Custom Fields & Info Requests
Build custom athlete profile fields in Payments > Forms, place them on signup and purchase pages, see who has not filled them in, email athletes and parents a request, and how recipients answer on the Complete profile page.
Overview
Custom fields are extra details your organization keeps on every athlete: jersey number, school, emergency contact, shirt size. An admin defines them once in Payments > Forms and decides on which pages they are asked. Staff see the answers on the athlete profile, and can email athletes and their parents a request for anything still blank. Recipients answer on the Complete profile page, and a request closes by itself once every required field has a value.
How To
Define the fields
Fields are built in Payments > Forms (admin only). Each field has a Label, an Answer type (Short text, Long text, Number, Date, Dropdown, Checkboxes or Yes / No), optional Help text, and a per-page setting for whether it is shown, required and how wide it is. The four pages a field can sit on are Checkout - Account, Checkout - Payment, Marketplace and the Missing info form. Building, arranging and deleting fields is covered in Forms; this article covers what happens with the answers.
Two rules matter for requests: a field required on Checkout - Account is also required when a parent creates a new athlete from My Athletes, and on the Missing info form a field is required unless you switch Required off. Optional fields never keep a request open.
Edit an athlete's answers (staff)
- On the athlete profile (Users > Athletes, then View Athlete), the Details card lists every field with its value and a count such as "3 of 5 filled in". Blank fields show as blank.
- Click Edit on that card, or open Edit Athlete, and fill in the Custom Fields section. Saving the athlete saves the answers.
- Connected apps can read and write answers with
connected_list_athlete_custom_fieldsandconnected_set_athlete_custom_field_values.
Values are validated per type: a number field rejects text ("must be a number"), a date must be a real calendar date, and a dropdown or checkbox answer must be one of the current options ("has an option that no longer exists").
Send a request for missing info (staff)
Open the request dialog from either place:
- Payments > Forms, Request missing info (admin).
- The athlete profile Details card, Ask for missing. This pre-selects the athlete and their blank fields.
In the Request missing info dialog:
- Under Which field?, pick one or more fields. Each option shows how many athletes are missing it, or "All filled in".
- Under Who should fill it in?, tick athletes. The list only contains athletes missing at least one picked field; Select all ticks everyone shown, and the search filters by name or email. An Asked [time] ago badge marks athletes with an open request for one of the picked fields.
- Add a Note (optional, 1,000 characters). It appears in the email and on the form.
- Click Send to N athletes.
What the server does for each athlete: skips them if none of the picked fields is blank, opens a request or adds the fields to the athlete's existing open request, and emails the athlete and every linked parent. The subject is "[Organization] needs a few details for [Athlete]". The toast reports "Request sent to N athletes." and how many already had it filled in. One send covers at most 500 athletes; larger selections go out in chunks, and if a chunk fails the athletes who did not get it stay selected for a retry.
Answer a request (athlete or parent)
- Follow the email link, or click Fill in on the banner "[Organization] asked for N details" on the dashboard or My Athletes.
- On Complete profile, each open request is a card headed Your details (athletes) or the athlete's name (parents), with "Requested by [Organization] on [date]", the coach's note, and the fields. Optional fields are marked (optional).
- Fill in what you can and click Save details.
Partial answers are kept. If required fields remain, the toast says "Saved. N required fields still to go." and the card stays. Once every required field has a value the card turns into "You're all set" and the request closes. A request also closes when staff or another parent fill the fields elsewhere.
Tips
- Put fields you must have before training on Checkout - Account and mark them Required, so new athletes cannot sign up without them.
- Use Marketplace or Checkout - Payment for details you only need from buyers; they are asked once, only while blank.
- Before a bulk request, pick the field first and read the count. It tells you exactly how many emails will go out.
- Re-sending is safe: a second request for the same athlete folds into the first, so they see one list.
- Connected apps can run the same workflow with
connected_get_missing_info_overviewandconnected_send_info_requests.
Troubleshooting
"A field with this name already exists." Another live field has that label. Rename it, or delete the old field first; deleted names can be reused.
"Add at least one option." Dropdown and Checkboxes fields need options. Switch the type or add one.
The athlete is not in the request list. They have already answered every picked field. Pick a different field to see who is missing it.
"Everyone has filled in [field]." Nothing to request for that field.
"Request sent to N athletes, then failed." A later chunk failed. The athletes who did not get the email are still ticked; click send again.
The banner says details are missing but the form is empty. The request closed because the fields were filled in elsewhere, or the requested fields were deleted. Reload the page.
"[Field] has an option that no longer exists." The saved answer is an option that was removed. Pick a current option and save.
Related
- Forms
- Managing Athletes & Groups
- Athlete Profile
- Parents & Guardians
- Athlete Billing & Marketplace
- Membership Offers & Payment Links
- Connected Apps (MCP)
Referenced by
- 'Athlete Profile'user management
- 'Parents & Guardians'user management