> For the complete documentation index, see [llms.txt](https://docs.unitlab.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unitlab.ai/documentation/queues/queue-failures-and-recovery.md).

# Queue failures and recovery

Find out why a task is stuck, missing or failed, and fix it.

When a task doesn't behave as expected, open it in the **Task Queue** and check its stage, status and assignee first.

![Task Queue showing a task's stage, status and assignee](https://292810646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGjVLUz4wthGkGlRKM6rM%2Fuploads%2F55z0p7NbmBasbWMJnyvJ%2Ftask-queue.webp?alt=media)

## Common problems

| Problem                                           | Check                                                               | Fix                                                                             |
| ------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| A button is missing                               | Your role, the selected stage, and who the task is assigned to.     | Ask a manager to assign it to you.                                              |
| Someone can't see unassigned tasks                | They are on the stage's list, and **Hide unassigned tasks** is off. | Change the stage settings.                                                      |
| Labels are saved, but the task doesn't move       | Saving doesn't submit. Required properties may be missing.          | Fill required values, then use **Send to Review** or the stage's submit button. |
| A rejected task sits untouched                    | The stage on the **Rejected** route has people on its list.         | Add people, or assign the task.                                                 |
| Status **Error** in a Model or Agent stage        | The run failed or timed out.                                        | Select **Retry**.                                                               |
| **Model failed**                                  | The model returned nothing, and the task moved on.                  | Label it by hand, or move it back to the Model stage.                           |
| The batch says **Completed**, but work isn't done | Completed only means processing finished.                           | Check the task's stage in the Task Queue.                                       |

## Moving tasks by hand

A manager can **Move** tasks to another stage. Use it to recover stuck work, not to approve it: a moved task has not been reviewed.

## When an upload fails partly

Items that processed stay. Fix the problem and upload only the failed files again. See [Batch Queue](https://docs.unitlab.ai/documentation/queues/batch-queue.md).

## Related

[Assignment and stage actions](https://docs.unitlab.ai/documentation/workflows/assignment-and-stage-actions.md) · [Model stages](https://docs.unitlab.ai/documentation/workflows/model-stages.md) · [Review, rework, and escalation](https://docs.unitlab.ai/documentation/workflows/review-rework-and-escalation.md)
