# Setting Up a Team Project
This guide walks through configuring a new Team Project from scratch: statuses, [[Custom Fields|custom fields]], default columns, member capacity and invitations. Your board is then ready before the first task lands.
If you haven't created the project yet, start with [[Getting Started with Team Projects]].
> [!quote] Set it up once, work from it daily
> A few minutes of configuration up front means the board speaks your team's language from day one. There is no backfilling fields or renaming statuses mid-sprint.
## The setup sequence
A freshly created project is usable immediately, but five minutes of configuration makes it yours:
1. Configure statuses to match your workflow
2. Set up labels for cross-cutting tags
3. Add custom fields for structured data
4. Set the default column layout
5. Set member capacity
6. Invite the team
---
## Step 1: configure statuses
Open the project, go to **Settings**, and find the **Statuses** section.
![[team-settings-statuses.png]]
New projects start with four defaults:
| Status | Meaning |
|--------|---------|
| **To Do** | Not started |
| **In Progress** | Being worked on |
| **In Review** | Done, awaiting review |
| **Done** | Complete |
From here you can:
- **Rename** any status to fit your team's language (for example "Blocked" or "Waiting on Client")
- **Recolour** a status to make it visually distinct on the board
- **Add** new statuses for stages your workflow needs
- **Mark as Done**: statuses in the Done group are hidden unless **Done tasks** is switched on in List view's **Display** menu
> [!tip] Match the status to the handoff
> The most useful statuses represent a clear handoff between people or stages. If a status doesn't represent someone doing something different, it probably doesn't need to exist.
---
## Step 2: set up labels
Labels are coloured tags for cross-cutting concerns that don't map cleanly to status, such as "blocked", "needs review" or "customer-facing". A task can have multiple labels.
From **Settings → Labels** (the tag icon):
- Add labels your team will actually use. Start with 3 to 5
- Assign a distinct colour to each so they're scannable on the board
- You can also create labels on the fly from the task row picker, so you don't need to define everything upfront
> [!warning] Name labels before using them
> Renaming a label does not migrate existing task data. Tasks with the old label name still show the old name as text but lose their colour. Settle on names before applying them widely.
See [[Labels]] for the full labels reference.
---
## Step 3: add custom fields
Custom fields let you attach structured data to every task: sprint names, client names, story points, links, due dates, or whatever else your team tracks. See [[Custom Fields]] for the full field reference.
![[team-custom-field-editor.png|508]]
From **Settings → Custom Fields**, add a field and choose its type:
| Type | Best for |
|------|----------|
| **Text** | Short labels, free-form notes |
| **Number** | Story points, estimates, counts |
| **Date** | Deadlines, target dates beyond the built-in due date |
| **URL** | Design files, spec links, Figma links |
| **Member** | A secondary owner, reviewer, or point of contact |
| **Select** | Fixed categories like sprint, phase, or client |
> [!tip] Start with select fields
> Dropdown (select) fields are the most useful for filtering and grouping on the board. Add one for sprint or phase first, then layer in others as the team asks for them.
For select fields, add the options you'll start with and assign colours to make them scannable on the list.
---
## Step 4: set default columns
From **Settings → Columns**, choose which columns are visible in List view by default and in what order.
Columns available:
- Status, Priority, Assignees (available on every project)
- Due Date
- Any custom fields you added in Step 3
> [!note] Members can override this
> The column layout you set here is the project default. Each member can adjust which columns they see without affecting anyone else. See [[Team List]] for how per-member column visibility works.
A clean starting layout shows the columns the whole team needs at a glance and leaves the rest hidden until someone needs them.
---
## Step 5: set capacity
From **Settings → Capacity**, set the daily working hours for the project. The default is 8 hours.
This number is what [[Team Today]] uses to show how full a member's day is when tasks are planned. If your team works 6-hour focused days or a shorter sprint day, set it here.
> [!note] Per-project, not per-person
> Capacity is set at the project level. All members share the same setting. Adjust it to match how your team actually works in this project.
---
## Step 6: invite members
From **Settings → Members** (or the invite button in the project header), add members by email address.
- Each person receives an invitation and joins when they accept
- New members see the project in their Team Projects list immediately after accepting
- The person who created the project is the **Owner**. Everyone else joins as a **Member**
See [[Getting Started with Team Projects]] for a full breakdown of roles and what each can do.
> [!highlight] You can invite before the board is fully configured
> Members won't see an empty, confusing board. They'll see the statuses and columns you set up, even if there are no tasks yet. It's fine to invite early.
---
## You're ready
Once statuses are set, fields are added, columns are arranged, and members are in, the board is ready to use. From here:
- **Add the first tasks** in List view or from the task button in the sidebar
- **Plan work into days** from the [[Team Today|Today board]]
- **Save your first view** once you've sorted and filtered the list the way the team prefers. See [[Team List#Saved views|Saved views]]
> [!success] Setup checklist
> - [ ] Statuses renamed and recoloured to match your workflow
> - [ ] Labels created with distinct colours
> - [ ] Custom fields added for your team's structured data
> - [ ] Default column layout set
> - [ ] Capacity set to match working hours
> - [ ] Members invited
---
**Next:** Learn how to manage tasks on your new board with [[Managing Team Tasks]].