---
title: "Projects"
description: "Projects let you group related conversations under a shared name, with optional instructions and shared context files. Click Projects in the sidebar to open the projects list."
url: "https://sotaagents.ai/manual/using-sotaagents/projects"
generated_by: "sotaagents-ldp"
docs_index: "https://sotaagents.ai/manual/llms.txt"
locale: "en"
---

# Projects

Projects let you group related conversations under a shared name, with optional instructions and shared context files. Click _Projects_ in the sidebar to open the projects list.

### Creating a project

1. #### Open the list

   Click _Projects_ in the sidebar. Use the tabs to switch between _Created by you_ and _Shared with you_. Sort by last modified, name, or created date.

2. #### Create

   Click _New project_, enter a name (required) and an optional description, then confirm. The project appears in the list immediately.

![The Projects screen listing two projects, with tabs for projects created by you and shared with you](/manual/assets/product/chat-projects-list-20260813.webp)
_A new project appears in the list straight away._

### Adding and moving conversations

1. #### Add to a project

   Click the **…** menu on any conversation — in the sidebar or inside a project — and choose _Add to project_. A submenu lists your projects; you can also create a new project from there.

![The three-dot menu on a sidebar conversation, with the Add to project submenu open listing the available projects](/manual/assets/product/chat-add-to-project-20260813.webp)
_Any conversation can be filed into a project from its three-dot menu._

2. #### Move or remove

   From the same **…** menu, choose _Move to project_ to send it to a different project (a confirmation is shown first), or _Remove from project_ to unlink it without deleting it.

### Inside a project

Opening a project shows a composer to start a new chat within the project, and the list of conversations it contains. The right sidebar lets you:

![A project page showing its conversations, an Instructions panel, project context files and members](/manual/assets/product/chat-project-detail-20260813.webp)
_Inside a project: its conversations, the instructions every chat inherits, shared context files and who can see it._

- **Instructions** — set a shared instruction that applies to every chat started inside the project.
- **Project context** — attach files or text snippets (up to 50 items) available in every project chat.
- **Members** — invite workspace members to the project and manage their access.

### Renaming and deleting

Use the **…** menu on a project card or on the project detail page to _Edit_ (rename or update the description) or _Delete_ the project. Deleting removes the project and its conversations immediately. This cannot be undone.
