Projects

Projects let each user organize related conversations into named workspaces. They are useful for long-running workstreams, teams, clients, classes, or any topic where you want a focused set of chats without relying on search alone.

Availability

Projects were added in LibreChat v0.8.7. There is no librechat.yaml setting, environment variable, or role permission that enables or hides them, so every signed-in user on a supported version has the feature. If you cannot find Projects anywhere in the interface, the instance is running an older version and needs to be updated.

What Projects Do

Group conversations in a named workspace with an optional description
Start a new chat already scoped to a project
Move an existing conversation between projects or remove its project assignment
Browse, sort, move, remove, or delete chats from the project workspace
Search projects by name or description and sort by latest activity, creation date, or name
Edit or delete projects from the dashboard, workspace, or sidebar

Projects are personal to the user who creates them. Other users do not see your project list, and a project cannot be shared or transferred.

A project is a grouping only. It carries a name and an optional description, and it does not add project-level instructions, files, or model settings to the chats inside it.

Create a Project

Open the projects page. In the sidebar, the Projects section header has an All projects button that opens it.

Choose New project, which is always available in the projects page header.

Name the project. A name is required and a description is optional. LibreChat then opens the project workspace.

The sidebar Projects section also has a New project button, but only while you have no projects yet. That section starts collapsed until you expand it or create your first project, so the projects page is the dependable entry point.

Project names are limited to 100 characters and descriptions to 1000 characters. Duplicate project names are allowed.

The Projects dashboard displays each project as a folder card with its description and chat count.

Work in a Project

Open a project to see its description and assigned chats. The workspace toolbar can sort chats by last update or creation date. Use New chat in project to open a scoped composer; its project chip confirms that the new conversation will be assigned to that project. The sidebar shows the same action on each project row.

Each project chat has an overflow menu with these actions:

Change project opens a searchable project picker
Remove from project keeps the conversation but clears its project assignment
Delete deletes the conversation after confirmation

Move Existing Chats

Open a conversation's menu and choose Change project, then select the project to assign it to. To take a chat back out, use Remove from project, which is only shown for chats that already belong to one.

A project workspace lists only the chats assigned to that project. The sidebar Chats list is unfiltered and keeps showing every conversation, including the ones assigned to projects.

Manage Projects

Each project appears in the sidebar. Use the project menu to:

Open the project workspace
Edit the project name and description
Delete the project

The projects page and the workspace header expose the same edit and delete actions.

Deleting a project removes the project assignment from its chats. The conversations themselves are not deleted.

Find a Project

The projects page has a Search projects box that matches project names and descriptions, and a sort control offering Latest activity, Created, and Name. Longer lists page in with Load more.

Notes

New chats started from a project keep that assignment when the conversation is created.
Project searches are case-insensitive and match both names and descriptions.
If a project is deleted while you are viewing it, LibreChat returns you to the projects list.