# Organizing with Projects

**URL:** <https://community.wingtask.com/t/organizing-with-projects/22>\
**Category:** Documentation\
**Created:** [June 4, 2026, 1:27am UTC](https://community.wingtask.com/t/organizing-with-projects/22 "2026-06-04T01:27:29Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![timcase](https://community.wingtask.com/user_avatar/community.wingtask.com/timcase/32/15_2.png) [@timcase](https://community.wingtask.com/u/timcase)\
**Post date:** [June 4, 2026, 1:27am UTC](https://community.wingtask.com/t/organizing-with-projects/22/1 "2026-06-04T01:27:29Z")

</div>

# Projects

## Overview

A project groups related tasks together under a shared label. Projects  
help you organize your work and see all related tasks at a glance.

* * *

## How It Works

### Assigning a project to a task

A task can belong to one project at a time. You assign a project by  
typing a project name when creating or editing a task.

If you assign a new project name that does not already exist, Taskwarrior  
creates it automatically.

### Project naming

WingTask follows the Taskwarrior convention for project names. Project  
names use capitalized segments separated by dots.

Examples:

```auto
Home
Work
Home.Gardening
Work.ProjectX

```

This convention keeps project names consistent and readable.

### Nested projects

Projects can be nested to any depth using dot notation.

Example:

```auto
Home
Home.Gardening
Home.Gardening.Plants

```

A task assigned to `Home.Gardening.Plants` belongs to that specific  
subproject. It also counts as part of `Home.Gardening` and `Home` for  
display and filtering purposes.

### How projects appear in the task view

When you view a project, WingTask displays tasks from that project and  
all of its subprojects together. This makes it easy to see everything  
under a parent project without switching views.

Example:

If you view the `Home` project, you will see tasks from:

- `Home`
- `Home.Gardening`
- `Home.Gardening.Plants`

* * *

## Examples

### Example: Simple project

Task:

```auto
Buy new garden hose

```

Project:

```auto
Home.Gardening

```

This task appears when viewing `Home.Gardening` or `Home`.

* * *

### Example: Nested project hierarchy

```auto
Work
Work.ProjectX
Work.ProjectX.Research
Work.ProjectX.Deliverables

```

Tasks can be assigned to any level of this hierarchy. Viewing `Work`  
shows tasks from all four projects.

* * *

## Screenshots

 ![project_editing](https://community.wingtask.com/uploads/default/original/1X/cf6dfaf185329352310b78a9bd3adba4b1c8ab6d.png)  
_A project can be added to a task using taskwarrior syntax_

 ![projects_list](https://community.wingtask.com/uploads/default/original/1X/81160257b64d790547baa211bdea1431abc726c8.png)  
_Projects and subprojects are listed in hierarchy_

 ![projects_broken_out](https://community.wingtask.com/uploads/default/original/1X/efd65c124bf7f9b9ba14696de0ce2d424bfb3173.png)  
_A project with subprojects will show tasks grouped at each level_

* * *

## Notes

- A task can only belong to one project at a time.
- Project names are case-sensitive. `home` and `Home` are different  
projects.
- Removing a project name from all tasks does not explicitly delete  
the project — it simply no longer appears once no tasks reference it.

* * *

## Related Topics

- [Focusing with Contexts](https://community.wingtask.com/t/focusing-with-contexts/25)
- [Working with Lists](https://community.wingtask.com/t/working-with-lists/24)
- [Adding and Modifying Tasks with Taskwarrior Syntax](https://community.wingtask.com/t/adding-and-modifying-tasks-with-taskwarrior-syntax/30)