> For the complete documentation index, see [llms.txt](https://docs.zbrain.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zbrain.ai/zbrain-documentation/zbrain-zsearch/projects-in-zsearch/creating-a-project-in-zsearch.md).

# Creating a project in ZSearch

Projects in ZSearch allow users to group relevant documents from search results into a focused workspace. Each project creates a scoped context where users can search, explore, and collaborate using only the selected files.

Projects are created after running a search and selecting documents from the search results.

Only files you are authorized to access can be added to a project.

#### Selecting files from search results <a href="#selecting-files-from-search-results" id="selecting-files-from-search-results"></a>

To begin creating a project:

1. Run a search using the search bar. Please refer to the **Searching in ZSearch** page for details on searching.
2. Review the search results
3. Select one or more files using the checkbox next to each result

Once at least one file is selected, ZSearch displays project-related actions above the results list.

<figure><img src="/files/JIjlBdvrC6iy0lBjiGWZ" alt=""><figcaption></figcaption></figure>

#### Creating a new project <a href="#creating-a-new-project" id="creating-a-new-project"></a>

After selecting files, you can create a new project:

1. Click **Create project**
2. In the **Create new project** dialog, enter a **project name**
3. (Optional) Add users to the project by selecting them from the list

<figure><img src="/files/Sthpv98ZQxs8tkcmaYJl" alt=""><figcaption></figcaption></figure>

4. Confirm to create the project

The selected files are automatically added to the new project.

#### Project workspace <a href="#project-workspace" id="project-workspace"></a>

Once a project is created, users are taken to the project workspace.

The project workspace includes:

* A project-specific search bar
* The list of project files
* Chat history for project-specific interactions
* Access to collaborators and project settings

<figure><img src="/files/YLqkj2ssep5YvQDxJAQr" alt=""><figcaption></figcaption></figure>

All queries and interactions within a project are scoped strictly to the files added to that project.

#### Editing and managing projects <a href="#editing-and-managing-projects" id="editing-and-managing-projects"></a>

Users can:

* Add more files to a project from new searches
* Remove files from the project (if permitted)
* Invite or remove collaborators
* Switch between projects using **My projects**

Projects persist across sessions and can be revisited at any time.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.zbrain.ai/zbrain-documentation/zbrain-zsearch/projects-in-zsearch/creating-a-project-in-zsearch.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.