---
title: "Targets"
description: "Track larger objectives and visualise progress with targets in Projectyl."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.projectyl.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Targets

Targets represent larger goals or milestones that multiple tasks contribute to. While tasks are the atomic units of work, targets are the outcomes you're working toward — think "Launch v2.0" or "Complete compliance audit" rather than individual to-dos.

> **When to use targets vs. tasks:** If something can be done by one person in a few hours or days, it's a task. If it requires multiple tasks across potentially multiple people and has a broader deadline, it's a target. Link tasks to targets to see how the small pieces add up to the big picture.

## View targets

The targets page shows a **grid of target cards**. Each card displays:

- Target name and **status badge**.
- Description preview.
- Labels (up to 3 shown).
- **Lead** and **member** avatars.
- **Task progress** bar (completed / total linked tasks).
- **Timeline bar** with start and target dates.

You can **filter** by status or search text, and **sort** by name, created date, start date, target date, or custom order.

## Target statuses

| Status          | Meaning                                            |
| --------------- | -------------------------------------------------- |
| **Backlog**     | Not yet started — parked for future consideration. |
| **Planned**     | Scheduled but not yet in progress.                 |
| **In Progress** | Actively being worked on.                          |
| **Paused**      | Temporarily on hold.                               |
| **Completed**   | Finished.                                          |
| **Cancelled**   | No longer being pursued.                           |

## Progress tracking

Target progress is calculated automatically based on linked tasks:

- The progress bar shows **completed tasks / total linked tasks** (e.g. 7/10).
- The bar colour changes based on proximity to the target date:
- **Green** — On track.
- **Yellow** — Approaching the target date with significant work remaining.
- **Red** — Past the target date (overdue).

There is no weighting — each linked task counts equally toward progress.

## Gantt view

Targets and their linked tasks are visualised together in the **Gantt chart** under the Tasks section. Targets appear as grouping headers with their tasks nested below. This is the best way to see how tasks within a target relate to each other over time.

See [Tasks — Gantt chart](/features/tasks#gantt-chart) for full details on the Gantt view, including dependencies, drag-to-reschedule, and holiday overlays.

## Target detail page

Click a target card to open its full detail page:

**Left column (Properties):**

- **Name** (editable).
- **Status** dropdown.
- **Lead** — single person responsible for the target's delivery.
- **Members** — additional people involved.
- **Labels**.
- **Start Date** and **Target Date**.
- **Task progress** bar showing completion.

**Right column:**

- Rich text **description** — supports formatting, [slash commands](/guides/tips#slash-commands), and @mentions.
- **Comments** — add comments, reply in threads, react with emoji.
- **Activity feed** — timeline of changes to the target.
- **Connections** — cross-references to/from other entities.
- **Attachments** — upload and manage files.

**Actions:**

- **Copy Link** — Share the target URL.
- **Delete** — Permanently remove the target (with confirmation).

Source: https://docs.projectyl.app/features/goals/index.mdx