Skip to main content
This guide explains how to create, edit, and manage players in the Tournament Management App.

​
Prerequisites

Before creating players, ensure you have:
1

Create at least one team

Players must be assigned to a team. Navigate to Equipos > Create to add teams first.
2

Create positions

Each player needs a position assignment. Go to Posiciones > Create to add positions (e.g., Goalkeeper, Defender, Midfielder, Forward).
3

Log in to your account

Player creation and editing require authentication.
If you try to create a player without teams or positions, the application will automatically prompt you to create these prerequisite entities first.

​
Creating a New Player

1

Navigate to the Players page

From the main navigation menu, select Jugadores (Players).
2

Click 'Crear jugador'

Click the Crear jugador (Create player) button.
3

Enter player information

Fill in the required fields:
  • Nombre del Jugador (Player Name): Enter the player’s full name
  • Número del Jugador (Player Number): Enter the jersey number (1-99)
  • Seleccione un equipo (Select a team): Choose from the dropdown
  • Seleccione una Posicion (Select a position): Choose the player’s position
4

Submit the form

Click Crear jugador (Create player) to save.

​
Player Validation Rules

​
Player Name Requirements

  • Required: Cannot be empty
  • Minimum length: 3 characters
  • Maximum length: 50 characters
  • Format: Only letters and spaces allowed (including accented characters)
  • Pattern: Cannot contain only numbers
Juan Pérez
Carlos Rodríguez García
Miguel Ángel Torres

​
Player Number Requirements

  • Required: Cannot be empty
  • Type: Must be a number
  • Range: Between 1 and 99 (inclusive)
  • Format: Only numeric digits allowed
1
10
99
Duplicate Prevention: You cannot create a player with the same name and number in the same team. However, the same player name or number can exist in different teams.

​
Viewing Players

The players list displays:
  • Player name
  • Jersey number
  • Associated team
  • Position
  • Action buttons (Detail, Edit, Delete)
All users can view player details, but editing and deleting require authentication.

​
Editing a Player

1

Locate the player

Find the player in the players list page.
2

Click 'Editar'

Click the Editar (Edit) button for that player.
You must be logged in to see this button.
3

Update player details

Modify any of the following:
  • Player name
  • Jersey number
  • Team assignment
  • Position
The player ID is read-only.
4

Save changes

Click Editar jugador (Edit player) to save your changes.

​
Edit Validation

When editing a player:
  • All the same validation rules apply
  • You cannot create a duplicate (same name and number in the same team)
  • Leading and trailing whitespace is automatically trimmed from the player name

​
Deleting a Player

1

Ensure you're logged in

Authentication is required to delete players.
2

Locate the player

Find the player you want to delete in the list.
3

Click 'Eliminar'

Click the Eliminar (Delete) button.
This button will be disabled if you’re not authenticated.
4

Confirm deletion

Confirm the action when prompted.
Unlike teams, players typically don’t have complex dependencies and can be deleted more easily.

​
Viewing Player Details

To see complete player information:
  1. Click the Detalle (Detail) button for any player
  2. This shows all player data including team and position information
  3. Available to all users without authentication

​
Common Scenarios

You can add multiple players to the same team, but each must have:
  • A unique combination of name and number within that team
  • A jersey number between 1-99
Different players can have the same number if they’re on different teams.
To transfer a player to another team:
  1. Click Editar on the player
  2. Select the new team from the dropdown
  3. Verify the jersey number doesn’t conflict with existing players on the new team
  4. Save the changes
Position changes are straightforward:
  1. Edit the player
  2. Select a new position from the dropdown
  3. Save
All available positions are shown in the dropdown.

​
Troubleshooting

This means another player with the same name and number already exists in the selected team.Solutions:
  • Change the player name
  • Choose a different jersey number
  • Select a different team
The application shows specific alerts:
  • Missing Teams: Click “Crear Equipos” to create at least one team
  • Missing Positions: Click “Crear Posiciones” to add positions
  • Missing both: Create both entities first
Ensure your number:
  • Is between 1 and 99
  • Contains only digits (no letters or special characters)
  • Is not empty
Check that your player name:
  • Has at least 3 characters
  • Doesn’t exceed 50 characters
  • Contains only letters and spaces (no numbers or symbols)
  • Isn’t only numbers
These actions require authentication. Log in to your account to enable these features.

​
Best Practices

Naming Consistency: Use full names consistently (e.g., always “Juan Pérez” not sometimes “J. Pérez”) to avoid confusion.
Jersey Numbers: Follow official soccer conventions - typically goalkeepers use number 1, and numbers 2-11 are for starting players.
Position Assignment: Make sure to create all standard positions (Goalkeeper, Defender, Midfielder, Forward) before adding players to ensure accurate team composition.

Build docs developers (and LLMs) love

Get started for freeTalk to us