⚽ Convocados Docs GitHub

Players & Bench

Manage who's playing and who's waiting.

Adding players

There are two ways to add players:

Player names must be unique within an event (case-sensitive) and are limited to 50 characters.

Autocomplete

The input shows suggestions from two sources:

Suggestions are sorted by frequency, with your last-used name at the top.

Bench system

When the number of players exceeds maxPlayers, additional players go to the bench. Bench players are shown separately with a numbered order.

Auto-promotion

When an active player leaves, the first bench player is automatically promoted to active status. Push notifications inform everyone about the change.

Removing players

Click the X on any player chip to remove them. If you joined via Quick Join, you'll see a "Leave" button instead.

Shield icon — linked accounts

When the event owner (or anyone with player-management permission) adds a player by name, Convocados checks if the name matches a registered user account. When it does, the new player is automatically linked to that account, so the player can see the event on their My Games page without any extra step.

In the quick-add chips and the autocomplete, a small shield icon appears next to any name that would auto-link. A name without a shield is still a valid add — it just stays anonymous, which is the right call when you're not sure who'll actually show up.

What matches

What does not match

Recovering an unlinked player

If you added yourself by name before the auto-link kicked in, you'll see a "Claim" button on the Rankings page. Tap it to link the record to your account. The owner can also remove the unlinked player and re-add them; the next add will auto-link.