---
title: Group tasks with Projects
sidebar_position: 11
---

# Group tasks with Projects

Projects let you **group chats** into distinct, manageable collections — and give each group its own tone, instructions, and shared files. Use them to keep context, preferences, and reference material scoped to one initiative: you switch from a client engagement to a launch plan without remixing prompts, re-uploading files, or losing track of past chats.

:::info
Projects are available on all plans. Limits may apply to the number of Projects and chats per Project. See our [pricing page](https://mistral.ai/pricing) for details.
:::

<SectionTab as="h2" sectionId="creating-a-project">Creating a Project</SectionTab>

1. Click the `New Project` button next to the `Projects` header in the left sidebar.
2. Choose a name and an icon for your Project.
3. Click `Create`.

Your new Project appears in the sidebar, ready to receive chats.

<SectionTab as="h2" sectionId="project-instructions">Project instructions and context</SectionTab>

Each Project can carry its own tone, instructions, and shared context that apply to every chat inside it. Open a Project to access these settings:

- **Tone**: pick a tone for this Project, or keep `Default (Global)` to inherit the tone from your account-level [Custom instructions](/vibe/work/custom-instructions).
- **Instructions**: click `Customize` to write Project-specific instructions — formatting rules, domain-specific guidance, or any persistent context that should apply to every chat in the Project.
- **Additional context**:
  - **Files**: click `Upload files` to attach documents, spreadsheets, PDFs, or images directly to the Project. Every chat can reference them without re-uploading.
  - **Other chats**: toggle `Include other projects' chats as context` to let Work draw on the other chats in this Project when planning new tasks.

<SectionTab as="h2" sectionId="managing-chats">Managing chats</SectionTab>

The Project overview page shows all your chats in list or grid view. From there you can add, move, or remove chats.

<SectionTab as="h3" variant="secondary" sectionId="adding-a-chat">Adding a chat</SectionTab>

**Drag and drop**

1. Locate the chat in the sidebar.
2. Drag it over the target Project name and release.

**Folder icon**

1. Open the chat.
2. Click the folder icon in the chat header.
3. Select a Project from the dropdown.

<SectionTab as="h3" variant="secondary" sectionId="moving-a-chat">Moving a chat to another Project</SectionTab>

Open the chat, click the folder icon, and select a different Project. The chat moves there automatically.

<SectionTab as="h3" variant="secondary" sectionId="removing-a-chat">Removing a chat</SectionTab>

**From the Project overview**

1. Open the Project.
2. Click the three-dots menu on the chat card.
3. Select `Remove from project`.

**From the chat itself**

1. Open the chat.
2. Click the folder icon.
3. Deselect the current Project.

Removing a chat from a Project doesn't delete it. The chat stays in your main chat history and can be reassigned at any time.

:::note
A chat can only belong to one Project at a time.
:::

<SectionTab as="h2" sectionId="deleting-a-project">Deleting a Project</SectionTab>

1. Open the Project.
2. Click the three-dots menu in the top-right corner.
3. Select `Delete` and confirm.

:::caution
Deleting a Project is permanent and can't be undone. The chats inside aren't deleted. They return to your main chat history and can be reassigned to another Project.
:::