Custom Attributes

Custom Attributes let you add extra fields to teams and players beyond the built-in fields. Use them to collect any additional information your tournament requires – license numbers, citizen card IDs, club registration codes, dietary preferences, or anything else specific to your sport or organization.

When to Use Custom Attributes

Custom Attributes are ideal for information that belongs directly on a team or player profile. Examples:

• Player license numbers or registration IDs required by your sports federation
• Citizen card numbers or national IDs for identity verification
• Club registration codes for tracking affiliated clubs
• Division levels to classify teams (e.g., Professional, Amateur, Youth)
• Insurance policy numbers for internal record-keeping
• Medical information or emergency contacts for players

Custom Attributes vs. Team Forms: Custom Attributes add fields directly to team and player profiles. Team Forms are separate questionnaires for collecting information like meal planning or accommodation needs. Use Custom Attributes for data that "belongs" to the team or player; use Team Forms for standalone surveys.

Creating Custom Attributes

Step 1: Navigate to Custom Attributes

1. Go to your tournament dashboard
2. In the sidebar, find the Settings section and click Custom Attributes

This page shows all your custom attributes with their label, type, entity type, and visibility settings.

Step 2: Create a New Attribute

Click New Custom Attribute to open the attribute form.

Example: Citizen Card Number (Player, Public)

A futsal tournament needs to verify player identities and display their citizen card numbers on the public website:

• Label: Citizen Card Number
• Applies To: Player
• Field Type: Text
• Required: No
• Helper Text: "Enter the player's national citizen card number"
• Visible on Public Website: Yes
• Visible on Participant Panel: Yes
• Editable on Participant Panel: Yes

This attribute will appear on the player edit form in the dashboard, on the Team Panel where team managers can fill it in, and on the player's public profile page.

Example: Document ID (Player, Private)

The same tournament needs an internal document ID for each player that should NOT be visible to the public:

• Label: Document ID
• Applies To: Player
• Field Type: Text
• Required: No
• Visible on Public Website: No
• Visible on Participant Panel: No
• Editable on Participant Panel: No

This attribute will only appear on the player edit form in the tournament dashboard. It will not be shown on the public website or the Team Panel – only tournament organizers can see and edit it.

Example: Division Level (Team, Public)

Classify teams into competitive divisions that are visible to the public:

• Label: Division Level
• Applies To: Team
• Field Type: Dropdown
• Options: Professional, Amateur, Youth, Recreational
• Required: No
• Visible on Public Website: Yes
• Visible on Participant Panel: Yes
• Editable on Participant Panel: No
• Visible on Registration Form: Yes

This attribute appears on the team profile in the dashboard, on the public team page, on the Team Panel (read-only), and on the public registration form so teams can select their division when registering.

Example: Insurance Policy Number (Team, Private)

An internal reference number that only organizers need:

• Label: Insurance Policy Number
• Applies To: Team
• Field Type: Text
• Required: No
• Visible on Public Website: No
• Visible on Participant Panel: No
• Editable on Participant Panel: No
• Visible on Registration Form: No

This attribute is only visible in the tournament dashboard. It is completely private to the organizer.

Attribute Settings

When creating an attribute, configure these settings:

Basic Settings

• Label – The name displayed to users (e.g., "License Number", "Club Registration ID")
• Applies To – Whether this attribute is for Teams or Players
• Field Type – The type of input field (see table below)
• Required – When enabled, this field must be filled in before saving
• Helper Text – Optional instructions displayed below the field (e.g., "Format: XX-YYYY-ZZZZ")

Visibility Settings

• Visible on Participant Panel – Show this attribute on the Team Panel so team managers can see it
• Editable on Participant Panel – Allow team managers to edit this field (only effective when visible)
• Visible on Registration Form – Show this attribute on the public registration form (team attributes only)
• Visible on Public Website – Display this attribute on the public team or player profile page

Field Types

Type	Best For	Example
Text	Short text values	License number, ID codes
Number	Numeric values	Age, jersey number
Dropdown	Choosing from predefined options	Division level, category
Checkbox	Yes/no confirmations	Eligibility confirmation
Date	Dates	Medical exam date, contract expiry
Text Area	Longer text	Notes, special remarks
Email	Email addresses	Alternative contact email
Phone	Phone numbers	Emergency contact phone
URL	Web links	Player profile URL, club website

Reordering Attributes

Drag and drop attributes in the list to change their display order. The order you set here determines the order in which attributes appear on edit forms, the public website, and other integration points.

Where Custom Attributes Appear

Tournament Dashboard (Always Visible)

Custom attributes always appear in the tournament dashboard, regardless of visibility settings. When editing a team or player, you will see a Custom Attributes section at the bottom of the form.

On the team edit page, team-type attributes appear in a collapsible section:

• All team custom attributes are displayed
• Fields are laid out in a two-column grid
• Required fields are marked with an asterisk (*)
• Helper text appears below each field

On the player edit page, player-type attributes appear similarly in a collapsible section within the player form.

Team Panel

When Visible on Participant Panel is enabled, team managers can see the attribute on their Team Panel. If Editable on Participant Panel is also enabled, they can edit the value.

This is useful for attributes that teams should provide themselves (e.g., license numbers, insurance details) while keeping internal attributes (e.g., organizer notes) hidden from team managers.

Registration Form

When Visible on Registration Form is enabled for a team attribute, it appears on the public registration form. This allows teams to provide the information when they register for your tournament.

After a candidate is converted to a team, the custom attribute values from the registration are automatically transferred to the team profile.

Note: Only team-type attributes can be shown on the registration form. Player attributes are not available during registration since players are added after the team is created.

Public Website

When Visible on Public Website is enabled, the attribute value is displayed on the team or player profile page on your tournament website.

On the team page, custom attributes appear as info cards in the team header section, alongside the team name and description.

On the player page, custom attributes appear in the player details grid, alongside built-in information like jersey number and position.

Only attributes that have a non-empty value are displayed. If a team or player has no value set for a public attribute, it will not appear on the public page.

Visibility Examples

Here is a summary showing how different visibility configurations work in practice:

Public Attribute (Visible Everywhere)

Setting	Value
Visible on Participant Panel	Yes
Editable on Participant Panel	Yes
Visible on Registration Form	Yes (team only)
Visible on Public Website	Yes

Use case: License number, citizen card number – information that teams provide and is publicly displayed.

Panel-Only Attribute (Team Managers Can See)

Setting	Value
Visible on Participant Panel	Yes
Editable on Participant Panel	Yes
Visible on Registration Form	No
Visible on Public Website	No

Use case: Emergency contact details, medical notes – information teams provide but that should not be public.

Read-Only Panel Attribute

Setting	Value
Visible on Participant Panel	Yes
Editable on Participant Panel	No
Visible on Registration Form	No
Visible on Public Website	No

Use case: Organizer-assigned classification or status – teams can see it but cannot change it.

Private Attribute (Dashboard Only)

Setting	Value
Visible on Participant Panel	No
Editable on Participant Panel	No
Visible on Registration Form	No
Visible on Public Website	No

Use case: Internal document IDs, organizer notes, insurance policy numbers – only visible to tournament organizers in the dashboard.

Tips

Keep labels clear and concise – Use descriptive names like "Citizen Card Number" rather than abbreviations like "CC#". These labels are shown to team managers and on the public website.

Use helper text for formatting – If you expect a specific format, add helper text like "Format: CC-12345678" to guide users.

Choose appropriate field types – Use Number fields for numeric data, Email fields for email addresses, and Dropdown fields when there are limited options. This ensures proper validation and a better user experience.

Consider privacy carefully – Only enable Visible on Public Website for attributes that should be publicly accessible. Personal information like document IDs should typically be kept private.

Use the registration form wisely – Only add attributes to the registration form that are essential for the registration process. You can always collect additional information later through the Team Panel or dashboard.

Required fields – Mark attributes as required only when the information is truly necessary. Optional fields give teams flexibility to provide information at their own pace.