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

# Tasks: Track everything you ask Biscuit to do

> Every request to build or change an app becomes a task. Create tasks, follow them as Biscuit works, review the changes, and keep your team's work in one board.

[YouTube video player](https://www.youtube.com/embed/BOQId6QqASk?si=q8leWOPGZkzUZi6s)

A task is anything you ask Biscuit to do: build a new app, add a feature to an existing one, or change how something works.

Tasks give you one place to see what's waiting, what Biscuit is working on, and what needs your review, across your own work and your team's.

## Where to find your tasks

When you sign in, you land on **My tasks**. This board shows the tasks created for you or owned by you.

Each space also has its own task board. Open a space and select **Tasks** to see everything happening in that team's space.

![Screenshot 2026 10 29 At 11 08 30](https://mintcdn.com/flits-886e81a8/NQiIabCUgblaSOLN/images/Screenshot-2026-10-29-at-11.08.30.png?fit=max\&auto=format\&n=NQiIabCUgblaSOLN\&q=85\&s=f4d5a323aa4f34df8cef50379f894867)

## Creating a new task

You can create a task in two ways: from the task board, or by editing an app.

### 1. From the task board

Use this when you want to plan an app or a feature, whether you start it now or later.

1. Click **Create task**.

   ![Screenshot 2026 10 29 At 11 10 24](https://mintcdn.com/flits-886e81a8/NQiIabCUgblaSOLN/images/Screenshot-2026-10-29-at-11.10.24.png?fit=max\&auto=format\&n=NQiIabCUgblaSOLN\&q=85\&s=fb57aedf6f7a8a1e672a579d35f20a91)
2. Describe what you want. For example: *"Build an invoice tracking tool for our operations team that generates invoices from the template I've attached."*

   ![Screenshot 2026 10 29 At 11 11 11](https://mintcdn.com/flits-886e81a8/NQiIabCUgblaSOLN/images/Screenshot-2026-10-29-at-11.11.11.png?fit=max\&auto=format\&n=NQiIabCUgblaSOLN\&q=85\&s=487fa8044942a91ec1fb2f27fdfcf2fa)
3. Optionally, click **Attach file** to add reference material, such as a PDF template, a screenshot, or a spreadsheet.
4. Choose the space the task belongs to, for example *Accounting team*. Leave it on **Auto** and Biscuit picks the space based on what you asked for.

   ![Screenshot 2026 10 29 At 11 13 55](https://mintcdn.com/flits-886e81a8/NQiIabCUgblaSOLN/images/Screenshot-2026-10-29-at-11.13.55.png?fit=max\&auto=format\&n=NQiIabCUgblaSOLN\&q=85\&s=582b4942b56cb8e6ad3dfc84e2edc786)
5. Turn **Auto start** on to have Biscuit start building as soon as you create the task. Turn it off to keep the task in **Todo** until you're ready.
6. Click **Create**. Biscuit may suggest improvements to your description before you create the task. Use them or ignore them.

> [!TIP]
>
> Turn **Auto start** off when you want to collect ideas for your team first and decide later which to build.

### 2. By editing an app

Every change you ask for in an app also becomes a task.

1. Open the app and click **Edit**.

   ![Screenshot 2026 10 29 At 11 16 37](https://mintcdn.com/flits-886e81a8/NQiIabCUgblaSOLN/images/Screenshot-2026-10-29-at-11.16.37.png?fit=max\&auto=format\&n=NQiIabCUgblaSOLN\&q=85\&s=547a8cfa810a13b21c413a55f7972ae2)
2. Type the change you want\_.\_ Attach files if needed.
3. Press **Enter** to send. The change appears as a task on the task board of the app's space, so your team can see what's being changed and by whom.

   ![Screenshot 2026 10 29 At 11 18 33](https://mintcdn.com/flits-886e81a8/NQiIabCUgblaSOLN/images/Screenshot-2026-10-29-at-11.18.33.png?fit=max\&auto=format\&n=NQiIabCUgblaSOLN\&q=85\&s=6a85b89b16f04e6a7a1dd0e4b2da9089)

## Task stages

Every task moves through four stages:

<table>
  <colgroup>
    <col width="135" />

    <col width="446" />
  </colgroup>

  <thead>
    <tr>
      <th>Stage</th>
      <th>What it means</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>**Todo**</td>
      <td>Not started yet, or you're still shaping it.</td>
    </tr>

    <tr>
      <td>**In progress**</td>
      <td>Biscuit is working on it.</td>
    </tr>

    <tr>
      <td>**To review**</td>
      <td>Biscuit has finished and needs you to check the changes or answer a question.</td>
    </tr>

    <tr>
      <td>**Done**</td>
      <td>The task is complete.</td>
    </tr>
  </tbody>
</table>

Tasks move between stages on their own as Biscuit works. You can also move them yourself: drag a task to another column, or select several tasks and move them together.

## Reviewing and approving a task

When a task reaches **To review**, Biscuit is waiting for you.

1. Open the task. It shows a preview of your app with the change applied. Go to the screen the task affected and check that it now works the way you asked. For example, if the task removed a filter from your app's home screen, open the home screen to confirm the filter is gone.
2. If the change looks right, choose how to finish the task:
   * **Approve and Publish:** the task moves to **Done** and the change goes live in your app straight away.

     ![Screenshot 2026 10 29 At 11 20 22](https://mintcdn.com/flits-886e81a8/NQiIabCUgblaSOLN/images/Screenshot-2026-10-29-at-11.20.22.png?fit=max\&auto=format\&n=NQiIabCUgblaSOLN\&q=85\&s=86f9e5a0022237c8b958fe3b7b88d9fb)
   * **Approve:** the task moves to **Done**, but the change isn't published yet. Use this when you want to make more changes through other tasks and publish them all together later.
3. If it's not what you wanted, tell Biscuit in the task and it goes back to **In progress** and returns to **To review** when the new version is ready.

> [!WARNING]
>
> Changes only reach your live app when you publish them, either with **Approve and Publish** on a task or by publishing the app. See [Publishing app](https://docs.biscuit.so/publishing-app.md).

## Filtering and sorting the board

When several tasks are running at once, use the filters at the top of the board:

* **All tasks:** every task, whether you, a teammate, or Biscuit created it.
* **Created by me:** only the tasks you created.
* **Needs my attention:** tasks waiting on you, such as an approval or an unanswered question from Biscuit. To keep the board tidy, choose whether to show only the latest tasks or all of them, and hide tasks you don't need to see.

  ![Screenshot 2026 10 29 At 11 24 10](https://mintcdn.com/flits-886e81a8/NQiIabCUgblaSOLN/images/Screenshot-2026-10-29-at-11.24.10.png?fit=max\&auto=format\&n=NQiIabCUgblaSOLN\&q=85\&s=9cbed9b7d45faaaf9d860b24d1069035)
* You can also order tasks within each column, for example by status or by **Last updated**.

> [!TIP]
>
> Check **Needs my attention** once a day to clear anything Biscuit is waiting on.

## FAQ

> [accordion] What happens if I don't choose a space for my task?
>
> Leave the space on **Auto** and Biscuit picks one based on what you asked for. For example, an invoice tool is likely to go to your accounting team's space. You can choose a space yourself at any time while creating the task.

> [accordion] Can I create a task without Biscuit starting on it straight away?
>
> Yes. Turn off **Auto start** before you click **Create**. The task stays in **Todo** until you start it.

> [accordion] Do changes from a task go live automatically?
>
> No. Biscuit moves the task to **To review** and waits for you. Click **Approve and Publish** to complete the task and put the change live, or **Approve** to complete it without publishing yet.

> [accordion] Can I group changes from several tasks into one release?
>
> Yes. Click **Approve** (not **Approve and Publish**) on each task. The tasks move to **Done** and the changes wait in your app until you publish, so they all go live together.

> [accordion] How do I undo a change Biscuit made in a task?
>
> Open the task and ask Biscuit to undo it in plain words, for example *"Bring it back."* Biscuit makes the change and sends the task back to **To review**.

> [accordion] How do I know when a task needs me?
>
> Use the **Needs my attention** filter on the task board. It shows every task that's waiting for your approval or an answer.

> [accordion] Who can see my tasks?
>
> You see every task you've created, plus the tasks in every space you have access to. You don't see tasks in spaces you don't have access to. See [Spaces](https://docs.biscuit.so/spaces.md).

> [accordion] What files can I attach to a task?
>
> You can attach reference files such as PDFs, screenshots, and spreadsheets. Biscuit uses them as context, for example an invoice template to base your invoices on.

## Up next

> [card] [Publishing app](https://docs.biscuit.so/publishing-app.md)
>
> Publish your app to your team or the web.

> [card] [Spaces](https://docs.biscuit.so/spaces.md)
>
> Organize apps and tasks by team.

> [card] [Working with Data](https://docs.biscuit.so/data.md)
>
> The built-in database behind every app.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.