> ## Documentation Index
> Fetch the complete documentation index at: https://docs.matchely.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams

> The squad with a name, a crest and a roster — for basketball, volleyball and other sports with 3 or more per side.

A **team** is your squad with a name of its own: a crest, a city, a roster that
changes and a page of its own. It is for sports with **3 or more players per
side** — basketball (3x3 and 5x5), volleyball (4x4 and 6x6) and the like. In
singles or doubles there are no teams; there what counts is the [competition
pair](https://docs.matchely.com/en/competitions/join.md#playing-as-a-fixed-pair).

You will find it in the menu, under **My teams**.

## Creating yours

Under **My teams → Create team** you give it a **name** (up to 40 characters),
pick the **sports** (1 to 4, only those with 3 or more per side), the **city**
and, if you like, a **description** (up to 280 characters). The crest comes
later, on the team's page.

> [!NOTE]
>
> To create one, your profile has to be complete **and carry at least one sport
> with 3 or more per side**. Without that, Matchely offers the shortcut to add
> the sport.

## The roster

On the team's page, **Roster** lists who is in. **Invite** finds the person by
name or **@username** — they get the invitation and have to **accept** to join;
until then they sit under **Invited**, and the invitation can be cancelled.

For each member you set:

* **Permission** — **Owner**, **Admin** or **Member**. The owner and admins
  invite, remove and edit the team; the owner can neither leave nor be removed.
* **Function** — **Athlete**, **Coach** or **Staff**. Whoever is not an athlete
  shows under **Staff**.
* **Position** — in the sports that have them (volleyball: setter, opposite,
  outside hitter, middle blocker, libero; basketball: point guard, shooting
  guard, small forward, power forward, center).
* **Jersey** — a number from 0 to 99, optional.

The roster holds **up to 30 people**, pending invitations included. **Leave**
takes you out of the team — to come back you need a fresh invitation.

## Playing as the team

The team does not create the match: it **marks** a match that is already
recorded. On the match page, **Mark as a team match** asks **Which team?** (when
you are in more than one) and **Who stayed on the bench?** — the roster players
who were there and did not play. The team's name then shows **on your side** of
the match, and the match lands on the **Matches** tab of the team's page.

> [!WARNING]
>
> **At least half of the players on your side must be on the roster** to use the
> team's name. With fewer than that, Matchely refuses the mark.

**Unmark** takes the match off the team's page — and erases the recorded bench.
The bench cannot be edited: unmark and mark again.

## What is not there yet

Teams are new, and a few things were left for later:

* **A scheduled match does not show** under the team's **Matches**: it only
  lands there after the match has been played.
* **Renaming the team does not change past matches** — they keep the name the
  team had on the day.
* **There is no way to delete a team.** The owner can empty the roster and leave
  it idle, but the page stays.
* A team has **no public page** and no followers, and does not link to an
  organization.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.