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

# Project Workflow

> How tasks move through a PixlHub project: the default Label, Review, Done pipeline, live task counts on each step, and the visual workflow editor with its node palette.

Every task in a project travels a pipeline, and the **Workflow** tab is where that pipeline lives: a visual graph you can read at a glance and reshape when your process outgrows the default.

## The default pipeline

New projects start with three steps wired together:

**Label** → **Review** (Accepted / Rejected) → **Done**

* Submitting a task in the editor moves it from Label to **Review**.
* A reviewer accepts it (forward to **Done**) or rejects it (back to **Label**, with comments explaining why).
* Each node shows a live count of the tasks currently sitting in that step, so the graph doubles as a bottleneck monitor: a fat Review count means labelers are outrunning reviewers.

<Frame caption="The Workflow tab: the default pipeline with live task counts, and the node palette along the bottom.">
  <img src="https://mintcdn.com/pixldata/yqUvWeFtQIe1UIvn/images/docs/projects/workflow-editor.jpg?fit=max&auto=format&n=yqUvWeFtQIe1UIvn&q=85&s=76ce2d471e1dc2ed831f4773b7b06f86" alt="PixlHub visual workflow editor showing Label, Review and Done nodes with task counts" width="1280" height="760" data-path="images/docs/projects/workflow-editor.jpg" />
</Frame>

## The workflow editor

The graph is editable: drag to rearrange, connect steps, and extend the pipeline from the node palette at the bottom of the canvas. **Templates** offers ready-made pipeline shapes, and **Save** / **Reset** manage your changes (the shipped pipeline is the sensible default until your QA process demands more).

<Frame caption="The node palette: building blocks for custom pipelines.">
  <img src="https://mintcdn.com/pixldata/yqUvWeFtQIe1UIvn/images/docs/projects/workflow-node-palette.png?fit=max&auto=format&n=yqUvWeFtQIe1UIvn&q=85&s=4108972448bac02d3eae5fe962cd5176" alt="Workflow node palette with Plugin, Import, Label, Review, Consensus, Run Model and Agent nodes" width="1045" height="70" data-path="images/docs/projects/workflow-node-palette.png" />
</Frame>

| Node          | What it adds to the pipeline                                     |
| ------------- | ---------------------------------------------------------------- |
| **Label**     | A human annotation step, assignable to specific people or anyone |
| **Review**    | A quality gate with accept and reject branches                   |
| **Import**    | An entry point for data flowing into the pipeline                |
| **Run Model** | A model inference step, for pre-labeling or automated checks     |
| **Agent**     | An AI agent step for intelligent processing                      |
| **Plugin**    | An integration hook for external systems                         |
| **Consensus** | Multi-annotator agreement (marked as coming soon in the palette) |

<Info>
  The assignment chip on a Label node (for example "Anyone") controls who can pull those tasks. Team roles decide who can pull from each queue; the dedicated guide for roles is on its way.
</Info>

## Reading workflow state elsewhere

The pipeline's state surfaces across the project so you rarely need to open the graph to know where things stand: the **[Tasks](/guides/essentials/tasks)** tab shows per-step queue counts and each task's current status; the project header's **Start Labeling** and **Start Reviewing** buttons show how many tasks wait in each queue; and the Overview tab tracks completion percentage against the whole pipeline.

## Practical patterns

* **Keep Review in the loop even for solo projects.** Reviewing your own day-old labels catches a surprising share of errors, and the Rejected path documents what changed.
* **Watch the node counts weekly.** They are the earliest signal of a staffing imbalance between labeling and review.
* **Extend only when the default hurts.** A second review step or a model pre-labeling node earns its complexity on high-stakes or high-volume datasets, not on a 200-image pilot.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What happens to a rejected task?">
    It returns to the Label step carrying the reviewer's comments. The original annotator sees the feedback pinned in context and resubmits after fixing.
  </Accordion>

  <Accordion title="Can different projects have different workflows?">
    Yes, the workflow belongs to the project. A quick internal dataset can run Label to Done while a production dataset runs a stricter pipeline.
  </Accordion>

  <Accordion title="Do I need to touch the editor to use PixlHub?">
    No. The default pipeline covers the standard label-review loop out of the box; the editor exists for the day your process needs more steps, models or integrations.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Tasks" icon="list-check" href="/guides/essentials/tasks">
    The queue view: filters, bulk actions, and per-task history.
  </Card>

  <Card title="Comments" icon="message" href="/guides/basics/comment">
    Where reviewer feedback lands, pinned to the pixels it concerns.
  </Card>
</CardGroup>
