> For the complete documentation index, see [llms.txt](https://docs.wrangle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wrangle.io/workflows/designing-a-workflow/task-lists.md).

# Task Lists

## How Task Lists Work

Wrangle's task list functionality assigns people to complete a checklist of one or more tasks.

![A task list posted to a Slack channel.](/files/-MjB81Sst0A8Zzcec_s2)

## When Task Lists Are Considered Complete

A task list is composed of one or more tasks. The overall task list is considered complete when all of its tasks are marked as complete.

## Launching One-Off Task Lists

Most task lists are launched via a [Wrangle workflow](broken://pages/-Mj5blROPstTOn9CIYfZ) for a recurring use case. But you can also start a one-off task list for work that comes up from time-to-time. For example, if you're working on a small project (outside of a workflow) you could create a one-off task list to assign different tasks to your colleagues.

You can launch a one-off task list in one of many ways:

* There's a button on the [Wrangle App Home page](/best-practices/wrangle-app-home.md)
* You can use Slack's search bar and look for "Start a Task List with Wrangle"
* You can use the Shortcuts menu by clicking the ➕ icon in the reply box and searching for "Start a Task List with Wrangle." Instead of clicking the icon, you can also type "/" in the reply box as well.

## Editing Task Lists In Progress

If a task list has not been completed, you can edit any incomplete tasks. You can add/delete tasks, rename them, and change who is assigned to each. You can't remove tasks that are marked as complete.&#x20;

{% hint style="info" %}
Not everyone can edit an in-progress task list.&#x20;

If the task list was created by a [workflow](broken://pages/-Mj5blROPstTOn9CIYfZ), it can only be edited by people assigned to a task or by the Workflow's Admins.

If the task list is a [one-off task list](/workflows/designing-a-workflow/task-lists.md#launching-one-off-task-lists), it can only be edited by people assigned to it, or to its creator.
{% endhint %}

## Assigning a Task List to an Out-of-Channel assignee

When a task list is assigned to someone who isn't a member of the workflow's Slack channel (such as for a private channel), Wrangle detects this and sends that person a direct message with the step instead of posting it in the channel.

Subsequent updates to that step thread continue in the same DM.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.wrangle.io/workflows/designing-a-workflow/task-lists.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
