You and your team
Teams
Make a team, invite people and set roles, share repositories and projects on a team board, and pay for Pro for your team.
A team has its own board, beside your personal board, where everyone sees the same tasks. Making and using a team is free.
Make a team
- Open Settings › Team › Members.
- Click Start your team, or New team if you are already on one.
- Type a Team name, adjust the suggested Username (lowercase letters, digits and dashes), and add a logo if you like.
- Click Create team. You become its owner.
The username appears in the team's share links, as in zokie.dev/@acme-labs/…. Owners change name, username or logo with Edit team on the banner. On two or more teams, a switcher at the top of Members picks which one you see.
Board tabs
Tabs at the top of the Plan area pick the board the Plan, Inbox and Archive show: All, your personal board, and one per team. The chat list always shows every team.
- Drag a tab to reorder it. Right-click for Team settings or Remove from tabs; + brings it back.
- A dot means a task on that board finished since you last looked.
Tasks on a team board
Teammates' tasks show beside yours. You can read them but not change them; the page says whose Mac runs each one. Start here takes a task nobody has started.
To move a task to a team, click the team chip in the chat header and pick a team. Its subtasks move too. It can't move back to your personal board. See Plan.
Members and roles
| Role | Can |
|---|---|
| Owner | Everything, including making owners and editing the team. |
| Admin | Invite people, pay for the team, set its rules, manage repositories and projects. |
| Member | Build with the team. |
Owners give any role to anyone else; admins make or unmake admins but never change an owner. Nobody changes their own role.
- Invite: type an email, pick a role, click Send invite. Pending people show as waiting; Withdraw cancels.
- Answer an invite: it shows at the top of Members with Join and Decline.
- Change or remove: pick a new role from the person's menu, or click Remove.
- Leave: click Leave on the banner. Owners can't leave.
Only owners change the team's board settings; others see them read-only. See Board settings.
Repositories and projects
In Settings › Workspace, Repos and Projects are shared per team. Only owners and admins change them.
- Map a repository: in Repos, click the team button on its row and pick a team, or tick rows (
⌘Aticks all shown) and click Map to team. Typeowner/nameto add one nobody has locally. Windows uses Ctrl in place of ⌘. - New chats that use a team's repositories land on its board, with a message saying which repository moved them. You can always move a chat from its menu. See Tasks.
- Groups: tick repositories, click Group…, name it (such as
Backend), pick its board and click Create group. A group attaches all its repositories to a new chat. - Projects: add one with Add project, then set its name, description, Colour and icon (emoji, website icon or image). Remove project shows only while no task uses it.
Only repositories with a GitHub remote are listed. A team holds up to 50 repositories; a board holds up to 100 projects.
Billing
Owners and admins can pay for Pro for the people they pick, in one payment. Each person covered is a seat. Members only see whether the team pays for their Pro. For prices, see Pricing.
- In Members › Pay for your team, tick people under Who to pay for (at least 2).
- Check the monthly total and click Pay for your team, then pay in your browser. Or Copy payment link for whoever holds the card.
Each person then shows Pro · paid by the team, Has their own Pro or Not covered. People who join later aren't covered until you pay for them.
- Pay for them gives someone a free seat; Stop paying frees theirs at once.
- Add a seat for them shows when every seat is used; Zokie shows the cost before you Pay and add the seat.
- Pay for fewer seats: free seats first, type the new count in Seats from the next bill (at least 2, and not below seats in use), then approve at the payment link. It applies from the next renewal; nothing is refunded.
For your own plan, see Plans.