Households and invites

Households

A household groups adults and players who belong together. It is not tied to a single team: the same household can be linked to every team where your family has a roster, so you manage members, dependents, and invites in one place. In the web app, Household lives under /user/team/household (with the rest of the team app) and lists everyone across linked teams, with each player’s team shown on their row. The old /user/household URL redirects there. On mobile, open Household from the app navigation for the same hub. Staff use households to simplify messaging and payment visibility on each team. Households self-heal: if the team links are missing for any reason, opening Household on a linked team re-derives the links from members' team rosters.

One household per account

Each Athleit account is in at most one household. If you already belong to a household, you must leave it before you can join a different household using a household invite code. Being on multiple teams does not mean multiple households: you still have a single household, and Athleit links that same household to each team where your family has a roster (for example when you create a household from a second team, the app links your existing household to that team rather than starting a second one). On any one team, you cannot belong to two different households at the same time—invites and join requests enforce that. Because the same household spans multiple teams, your household invite code stays the same regardless of which team you share it from.

For payments, a household is required for both team and club payment events. If a player manages their own account with no parent attached, they still must create or join a household before they can pay.

For previously created team payment events, joining the team later does not automatically add that player to older requests. After the player joins or creates a household, a team staff member must open each relevant payment event and select Add newly eligible players.

Households do not use a separate display or “family” name in the app. People are grouped by membership; when you create a household you start with your account in that group. Teammates see who is in the household from the roster and household screens for each team where the household is linked.

When you don’t have a household yet

If you are on a team’s roster but are not in a household yet, the Household screen offers join with a household code and create a household.

• Web: Both actions appear in one card, centered on the page, with a border between the “join with a code” section and the “create” section.
• Mobile: The same two actions appear as two stacked cards (create and join). The behavior matches web; only the layout differs.

Pending household join requests or invites may still appear above those controls.

Household invite code vs dependent claim / join code

These are different codes:

• Household invite code — Belongs to the household. Share it with someone who is already on that team so they can request to join your household (a parent or staff member may need to approve). When they use it, your household is linked to that team if it was not already. On Household, this appears when your household has an invite code (copy/rotate may be available depending on permissions).

• Dependent claim code (six characters, similar to a team invite code) — Used when a child has no Athleit login yet. A parent shares this code so the player can claim their roster spot during onboarding (or the dedicated claim flow). It is not the same as the household invite code.

On the web Household list and table, the column for a dependent’s signup code is labeled Join code. In the mobile member detail sheet for a dependent, the same value is labeled Claim code. The underlying code is the same; labels differ by surface.

Adding a child

Add a child opens a drawer (web) or sheet (mobile). The Team picker is optional — checkboxes list every team your household is linked to, and you can pick none, one, or several. Selecting nothing creates a household-only dependent; selecting a team rosters the child on it immediately (with that team's jersey number and position). When your household isn't linked to any team yet, the picker has no options and the child is created household-only by default. A household-only dependent shows a Not on a team yet pill on the household list; roster them on a team later from their detail.

Where to find, copy, and refresh a dependent’s code

After a parent adds a child without a login (or when viewing any dependent who already has a code):

1. Open Household and tap or click the child’s row to open member detail (drawer on web, bottom sheet on mobile).
2. Find the code in a dotted-border area (clear background). Use Copy to share it with the player for onboarding.
3. Use Refresh (icon) inside that area to generate a new code if the old one was compromised or used; share the new code with the player.

The code is not shown as a separate “latest claim code” banner on the main Household screen on mobile; open the child’s detail to see or refresh it. After adding a child, the sheet may open from your workflow, or you can open their row from the Members list.

Add an existing child to more teams

A dependent can sit on multiple teams that the household is linked to, with per-team jersey number and position. To roster a child you've already added on another team:

1. Open Household and tap or click the child's row to open member detail.
2. In the Teams section of the detail, use Add to team and pick a team your household is linked to.
3. Set the per-team jersey number and position if applicable; these can differ from any other team the child is on.
4. The child appears on that team's roster immediately. Repeat for any additional teams they belong to.

To remove a child from one team without removing them from the household, use Remove from roster on that team's row in the Teams section.

Managing members (web and mobile)

1. Open Household and choose a member to open their detail (drawer on web, bottom sheet on mobile).

2. Leave the household yourself — Use Your membership on the main Household screen, or open your own row and choose Leave household. You may be able to rejoin later with a household code or invite if your team allows it.

3. Remove another adult — Parents and staff can remove from household another adult who is not the person who originally created the household. The creator of the household can remove other members too; no one else can remove the creator—only the creator can exit by leaving the household. Players cannot remove parents through this action.

4. Remove from roster (per team) — In the member detail Teams section, Remove from roster drops that person from that team’s roster only (for roster players or dependents without their own login). For a dependent that's the per-team record (jersey/position); for an adult that's their team membership row. The dependent stays in the household and on any other teams they're rostered on; this is not the same as remove from household, which drops the dependent record entirely or removes an adult from the household. Payment history is preserved whether you remove a player from a roster, remove a household member, or delete the whole household — the recipient row is retained with the player and team name snapshotted at the time the payment was created. For the complete picture across player, team, club, and household deletion, see How Athleit retains payment records.

5. Pending requests — When you have open household invites or join requests, Household shows a short notice. Work with a parent or staff member on your team if you need help finishing a request.

Invite codes

Teams distribute team invite codes so parents and players join the correct roster. Codes are scoped to the team that issued them.

Each household has a household invite code (unique across Athleit). Share it with someone already on that team so they can request to join your household (a parent or staff member may need to approve). When they use the code, your household is linked to that team if it was not already.

Staff join requests

When someone requests to join as staff, an existing staff member may need to approve the request before access is granted.

Claim player (players without a login yet)

Younger players who were added as dependents (no Athleit account) use a claim flow so their account links to the right roster and household:

• During onboarding, choose Household → Claim player for the 6-character claim code a parent shared, plus their name as it should appear on the roster.
• The Household section of the hub also lists Join household (team invite code + 6-character household code) and Claim player; without a team yet, those routes may send you through onboarding first.

On mobile, a successful claim does not show a blocking success popup; the app continues (for example loads Home or your dashboard). If nothing seems to happen, pull to refresh or check that you are signed in and the code is correct.

Club note

Club registration events are separate and use their own public links and form fields. Club staff still see households per team in the club footprint, backed by the same household ids when teams share members.

Mobile: quiet success for some Household actions

On mobile, creating a household, adding a child, or claiming a player spot may complete without a success alert; the screen updates (new household, member list, or navigation) instead. Errors still surface as messages you can read. If you expected a popup, check that the action succeeded in the UI.