# Task Statuses (https://yapl.app/en/docs/user-guides/tasks/task-statuses)

# Task Statuses

Task statuses track workflow progress from start to completion. YAPL provides default statuses and supports custom statuses for your workflow.

## Understanding Statuses

Statuses provide:

- **Progress Tracking** - Where is the work?
- **Visual Indication** - Color-coded views
- **Workflow Management** - Move through stages
- **Kanban Columns** - Board organization

## Default Statuses

YAPL includes these default statuses:

| Status | Description | Color |
|--------|-------------|-------|
| **To Do** | Work not started | Gray |
| **In Progress** | Actively being worked | Blue |
| **In Review** | Pending review/approval | Yellow |
| **Completed** | Work finished | Green |

## Status Flow

### Typical Workflow

```
To Do → In Progress → In Review → Completed
```

### Flexible Movement

Tasks can move:
- Forward through workflow
- Back if rework needed
- Skip stages if appropriate

<Callout type="info">
YAPL doesn't enforce strict workflow order. Tasks can move to any status as needed.
</Callout>

## Changing Status

### From Task List

1. Click on task
2. Find status dropdown
3. Select new status
4. Automatically saved

### From Kanban Board

1. Drag task card
2. Drop in new column
3. Status updated

### From Task Details

1. Open task detail view
2. Find status field
3. Select new status
4. Save changes

## Status Colors

### Visual Identification

Each status has a color:
- Appears in Gantt bars
- Shows in Kanban cards
- Visible in task lists

### Default Colors

| Status | Default Color |
|--------|---------------|
| To Do | Gray/Light |
| In Progress | Blue |
| In Review | Yellow/Orange |
| Completed | Green |

## Custom Statuses

### Adding Custom Statuses

Workspace administrators can add custom statuses:

1. Go to **Settings > Organization**
2. Find **Task Statuses** section
3. Click **Add Custom Status**
4. Enter status name
5. Select color
6. Save

### Custom Status Examples

| Industry | Custom Statuses |
|----------|----------------|
| Construction | Site Ready, Inspected, Punch List |
| Software | Code Review, QA Testing, Deployed |
| Design | Draft, Client Review, Approved |

### Multi-language Support

Custom statuses can have:
- English name (required)
- Turkish name (optional)
- Other translations as supported

## Statuses in Kanban

### Column Mapping

Kanban columns represent statuses:
- One column per active status
- Tasks appear in their status column
- Drag between columns to change status

### Column Order

Columns arranged in workflow order:
- Left to right progression
- Customizable order
- Hide unused statuses

## Statuses in Gantt

### Bar Colors

Task bars colored by status:
- Quick visual assessment
- Filter by status
- Legend shows mapping

### Status Changes

Changing status in Gantt:
- Open task details
- Change status there
- Bar color updates

## Status and Progress

### Relationship

Status and progress are related but separate:

| Status | Progress Range |
|--------|----------------|
| To Do | Typically 0% |
| In Progress | 1-99% |
| In Review | Usually high % |
| Completed | 100% |

### Auto-Progress (Optional)

Some configurations may auto-set progress:
- Completed status → 100%
- To Do status → 0%

## Filtering by Status

### Task List Filter

1. Open filter panel
2. Select status filter
3. Choose statuses to show
4. View filtered results

### Kanban Filter

1. Use column visibility
2. Hide/show columns
3. Filter within columns

### Gantt Filter

1. Open filter options
2. Select by status
3. Show matching tasks

## Status Reports

### Status Summary

Dashboard may show:
- Tasks by status count
- Status distribution chart
- Status trends over time

### Progress by Status

View progress metrics:
- Per-status task counts
- Completion rates
- Bottleneck identification

## Best Practices

### Keep Statuses Simple

- Use minimal statuses needed
- Avoid status overload
- Each status should be meaningful

### Consistent Usage

- Define status meanings clearly
- Train team on when to use each
- Review status usage periodically

### Regular Updates

- Update status promptly
- Don't leave stale statuses
- Status reflects current reality

## Managing Workspace Statuses

### Who Can Manage

Workspace owners can:
- Add custom statuses
- Edit status properties
- Reorder statuses
- Deactivate unused statuses

### Impact of Changes

Changes affect:
- All plans in workspace
- Existing tasks with that status
- Kanban column display

<Callout type="warn">
Removing a status may affect tasks currently in that status. Plan carefully.
</Callout>

## Troubleshooting

### Status Not Changing

- Verify you have edit permission
- Check for validation rules
- Ensure save completed

### Missing Status Option

- Status may be inactive
- Check workspace status configuration
- Contact workspace admin

### Kanban Column Missing

- Status may be hidden
- Check column visibility settings
- Verify status is active

### Colors Not Showing

- Check view settings
- Verify color configuration
- Refresh the view

## Related Topics

- [Task Properties](/docs/user-guides/tasks/task-properties) - All task properties
- [Kanban Board](/docs/user-guides/kanban) - Board-based management
- [Creating Tasks](/docs/user-guides/tasks/creating-tasks) - Task creation