Skip to main content

Set a task's state by hand

Most tasks move from state to state by themselves, or with Start, Stop, Reset and Complete. When a task is stuck in the wrong state, such as one that finished its work but still reads Running, set its state by hand. Any state can move to any other.

Who can do this: anyone who may run the task, which needs edit access to its project. Others see no State row on the Details tab; the state icon at the top of the page still shows it.

  1. Open the task from the task board.

  2. Select the Details tab. Summary opens with State as its first row: the current state and Change… beside it.

    The Details tab's Summary: State reads Done with Change… beside it, then Language, Parent, Created, Updated, Created by, Updated by, Source, Runner and Project memory

  3. Select Change…. A list replaces the state, set to the current one.

  4. Pick the state you want: Draft, Queued, Running, Asking, Failed, Paused or Done. Picking the current state does nothing.

  5. Read the confirm. Its title names the move, such as Set state to Done?, with the task's number and title, and one line on what the move does:

    Move toWhat it does
    DraftEnds any runner, frees its slot and clears this attempt's results. On an epic, stops its stage tasks.
    QueuedQueues it for a runner. A live runner is stopped first. On an epic, this starts it.
    Running, AskingSets the state only. No runner is started or asked.
    PausedEnds any live runner; the slot is kept.
    FailedEnds any live runner and marks it failed.
    DoneCloses it. The outcome is not verified.
  6. Select the confirm button, such as Set Done, or Cancel to leave the state as it was.

  7. Check State and the state icon at the top of the page: both show the new state.

Change… is greyed out while the Task tab has unsaved changes. Save or discard them first. If the move fails, the reason shows under State.