> For the complete documentation index, see [llms.txt](https://docs.struct.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.struct.com/tutorials/guides/how-to-use-tasks/how-to-set-up-and-edit-a-task.md).

# How to set up and edit a task

This page will take you through the process of creating and editing a task.

### Set up a task from the overview

To create a new task, go to the top right menu, select 'Tasks', then 'Go to task overview' and click 'Create task' to create a new task.

<figure><img src="https://2141378775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuUonpFWM7AJ0xVVXV1tr%2Fuploads%2FD1V0raewkgyTrpX3tCiI%2Fimage.png?alt=media&amp;token=dbfdc783-4245-4a04-abb0-7fc05b0d05d2" alt="This is the overview page where you are able to create and filter tasks."><figcaption><p>Overview page where you are able to create and filter tasks.</p></figcaption></figure>

This will present you with the 'Create task'-page.

<figure><img src="https://2141378775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuUonpFWM7AJ0xVVXV1tr%2Fuploads%2FvU4W8QxxXnomP5d7pbkJ%2Fimage.png?alt=media&amp;token=abcf2e64-e72b-47b1-baf7-aa474f51a368" alt="The page where you can create a task"><figcaption><p>The 'Create task' page</p></figcaption></figure>

Select an appropriate title and assign responsible users for the task. We recommend that you add a concise description to ensure the assigned user(s) has sufficient context for the assignment. You can add a deadline if the task has one.

{% hint style="info" %}
If you frequently create tasks that a group of users can handle, consider creating a [User Group](/reference/user-management/user-groups.md) and assigning it to this group instead.
{% endhint %}

You can attach multiple entities to the task, such as [products](/fundamental-concepts/data-management.md), [categories](/fundamental-concepts/data-model.md), variant groups, [variants,](/fundamental-concepts/data-management.md) assets and [global list values](broken://pages/33UGJbwodzi2bP6o2PZJ).&#x20;

When you're ready, you can create the task. You can now safely go back to the overview page.

### Set up a task from a product page

To create tasks directly from a [product](/fundamental-concepts/data-management.md) page, go to the desired [product](/fundamental-concepts/data-management.md) from the product catalogue. Click the kebab menu <i class="fa-ellipsis-vertical">:ellipsis-vertical:</i> in the top-right corner and select 'Create task'. This will add the [product](/fundamental-concepts/data-management.md) automatically to the tasks entities list.

<figure><img src="https://2141378775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuUonpFWM7AJ0xVVXV1tr%2Fuploads%2FNUus0jm3iObwIj13Keyq%2Fimage.png?alt=media&amp;token=6edd2832-528b-4de6-87f2-c5978e44f83f" alt="A product page where the user has clicked on the dotted icon and hovering over the &#x27;Create task&#x27; button."><figcaption><p>The product page from where you can create a task related to the specific product. This will attach the product as an entity to the task automatically.</p></figcaption></figure>

### Edit a task

To edit a task, go to the task overview page. If you can not find the task, use the top menu to filter or search for the task title. Hover over the desired task to reveal a menu on its right. Click the "Edit" <i class="fa-pencil">:pencil:</i> icon.

<figure><img src="https://2141378775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuUonpFWM7AJ0xVVXV1tr%2Fuploads%2FO1Cl0bwB77N8Ozx7Lb48%2Fimage.png?alt=media&amp;token=c948dbdf-3976-4632-865a-436fb74fe845" alt="The menu that pops up when you hover over the task on the task overview page"><figcaption><p>The tooltip that pops up when you hover over the specific task.</p></figcaption></figure>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.struct.com/tutorials/guides/how-to-use-tasks/how-to-set-up-and-edit-a-task.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
