# Projects & Labels
Projects and labels are the base of how Zaphiri organises your work, building on the [[Day-First vs. Task-First]] approach. Together they create a simple matrix that shows both **who you are doing the work for** and **what type of work it is**. Getting them right early makes your [[Time and Energy Report]] meaningful.
## The Zaphiri Matrix concept
![[settings-labels-projects.png]]
> [!note] The Zaphiri Matrix
> Think of projects and labels as a simple grid: **Projects = who or what for**, **Labels = what type of work**. Together they show where your time and energy actually go.
### Projects (who or what for)
| Definition | Client, company, initiative, or personal area |
|-------------|----------------------------------------------|
| Examples | Client A, Marketing Site, Personal Finance |
| Good names | “Acme Corp”, “Product v2”, “House Project” |
| Best used for | Grouping tasks by stakeholder or outcome |
| Setup tips | Keep purposeful and distinct |
### Labels (type of work)
| Definition | Activity category you perform |
|-------------|-----------------------------------------------|
| Examples | Meetings, Emails, Coding, Accounting |
| Good names | “Design”, “Research”, “Sprint Review”, “Admin”|
| Best used for | Classifying tasks by activity type |
| Setup tips | Keep broad and consistent |
> [!highlight] Quick examples
> - Weekly team call → **Project:** Client A • **Label:** Meeting
> - Monthly invoicing → **Project:** Your Business • **Label:** Accounting
## Working with projects and labels
In the left-hand panel you will see your **pinned** items first, with **Show All** for the full list.
- Select any project or label to filter your tasks for the current week.
- The filter **stays on in [[Today View]]** as you work.
- Switching between **Work** and **Personal** keeps the filter in place.
> [!note] Where they appear
> Projects and labels are consistent across Zaphiri:
> - **Sidebar filters** for quick focus
> - **Task cards** for context at a glance
> - **Reports** for insights into time and energy
>
> Once set up, they appear throughout the app.
## Managing and customising
Open **Settings → Labels & Projects** (from your profile image) to manage everything.
- **Add** new labels or projects
- **Pin** important ones to the sidebar
- **Change colours** on labels
- Manage **Work** and **Personal** contexts separately
> [!tip] Work and Personal
> Switch context in Settings to see your **Personal** labels and projects. Switch back for **Work**.
### Safety features
Zaphiri protects your work with built-in safeguards:
> [!success] Data protection
> - **Deletion confirmation**: deleting a label or project opens a confirmation dialog
> - **Hide, don't delete**: tasks linked to deleted labels or projects are hidden, not permanently removed
> - **Duplicate prevention**: Zaphiri prevents duplicate label and project names within the same work type
These safeguards stop you losing important work by accident when you reorganise your projects and labels.
### The Zaphiri Matrix tool
Need help getting started? Use the built-in **Zaphiri Matrix tool** to:
- Generate suggested projects and labels for Work and Personal
- Step through a guided setup
- Create a solid starting point you can refine later
## Automatic suggestions
When you [[Add Tasks|create a task]], Zaphiri learns from your history and suggests the best **label** and **project** for each new task. Suggested values glow purple, so you can tell them apart from values you set yourself.
- **Keyword matching**: Zaphiri recognises patterns in your task names and matches them to your existing labels
- **Fuzzy matching**: minor typos in project names still produce accurate suggestions
- **Work and Personal**: suggestions match your current context, so work labels do not appear when you are in Personal mode, and vice versa
- **AI fallback**: for ambiguous tasks, an AI model gives a best-guess suggestion with its reasoning
- **Learning**: every task you create improves future suggestions, and your manual changes take effect straight away
> [!tip] Just start typing
> You do not need to configure anything. After a few tasks, Zaphiri picks up your patterns and starts suggesting labels and projects.
## Get help choosing a label
Open [[AI Chat Assistant|Ask Zaphiri]] in personal Tasks mode and ask which existing label fits your work. Reference a task with `/task` to compare its current label with the available labels in that task's Work or Personal view.
Apply the recommendation from the task's label control. Ask Zaphiri's lookup gives advice without changing your labels.
## Why it matters
- Organises tasks into a clear, flexible structure
- Powers your [[Time and Energy Report]] insights
- Connects with [[What Are Energy States?|energy labels]] for deeper analysis
- Keeps your system adaptable as your work changes
> [!success] The key idea
> Projects = **who or what for**. Labels = **what type**. Together they give you clarity and reporting across all your work.
---
**Next:** Learn how to keep work and personal apart with [[Work & Personal Contexts]].