> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/guides-and-quickstarts/workspace-and-discovery/folders-and-project-organization.md).

# Folders and project organization

Folders keep related projects together. Create a folder for a team or purpose, then move projects into it.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSQ1Sgy933krTyK0S4JpP%2Fuploads%2FxYM7MoRpMvBisKrYfYJ2%2FG005.mp4?alt=media&token=3554d7a7-d5ad-4c81-b007-96f94a481d5d>" %}

## Create a folder

In Projects, select **New Folder**. Enter a name and choose whether to make the folder private. Select **Create Folder**.

![New folder name and privacy controls](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/3wVUwofGXr2Y6qbi4dZC/assets/g005-g005-01-create-folder.png)

## Move a project

Open the project menu and select **Move to**.

![Project Move to menu action](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/EJ3C08GKaK596nwOLEC6/assets/g005-g005-02-project-move-menu.png)

Choose the destination folder, then select **Move To Folder**.

![Destination folder selection](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/Kh60H6UPvsc1FzEJVAfe/assets/g005-g005-03-select-destination.png)

The project appears in the destination folder and leaves its previous location.

![Project in the destination folder](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/Fv7xaHpnVBXuCRwZNdzr/assets/g005-g005-04-verify-destination.png)

## Manage a folder

Open the folder menu and select **Settings** to change its name or privacy. Select **Pin To Top** to keep it near the top of the sidebar.

![Folder settings and pinning actions](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/Z4rV4A8daZAcxBR0BE2Y/assets/g005-g005-05-folder-settings.png)

To move a project to a different folder later, use **Move to** again and choose the new destination.

![Project moved to another folder](https://content.gitbook.com/content/SQ1Sgy933krTyK0S4JpP/blobs/bhxTWwiDMPlI9lmKkM1s/assets/g005-g005-06-restored-location.png)

## Important behavior

Moving a project preserves the project. A private folder has its own access controls, so review folder sharing when moving work that other people use.

## Check access after moving a project

If colleagues need the destination folder, follow [Project sharing and permissions](https://docs.stackai.com/guides-and-quickstarts/workspace-and-discovery/project-sharing-and-permissions.md) and ask an intended member to open the project after the move.


---

# 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.stackai.com/guides-and-quickstarts/workspace-and-discovery/folders-and-project-organization.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.
