> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Projects in Orq.ai

> Organize AI resources with projects. Group prompts, deployments, agents, and knowledge bases. Manage team access and permissions for isolated environments.

Projects are the top-level organizational unit in **orq.ai**. Each project is a workspace-level container that holds **Deployments**, **Prompts**, **Agents**, **Knowledge Bases**, and **Datasets**. Create separate projects to isolate environments, control team access independently, and keep observability data scoped per use case. For example, separate production and staging into distinct projects to scope API keys, permissions, and trace data independently.

If the top bar shows a project name dropdown, **Sidebar V2** is active: use the **New navigation** tab. If the sidebar shows a **Projects** section with a <kbd><Icon icon="plus-large" /></kbd> button, use the **Default navigation** tab.

## Using Projects

<Tabs>
  <Tab title="Default navigation">
    Create a new **Project** by clicking the <kbd><Icon icon="plus-large" /></kbd> button next to **Projects** in the **AI Studio** sidebar.

    Within a project, add entities (including [Playgrounds](/docs/ai-studio/prompts/playgrounds), [Experiments](/docs/experiments/overview), [Deployments](/docs/deployments/overview), [Agents](/docs/ai-studio/ai-engineering/build-agents), and more) using the <kbd><Icon icon="plus-large" /></kbd> button inside the project.

    <Frame caption="Add any entity to a project using the '+' button inside the project.">
      <img src="https://mintcdn.com/orqai/9ezrEik8zdClmQ3y/images/project-add.png?fit=max&auto=format&n=9ezrEik8zdClmQ3y&q=85&s=40f094015ee7aa180437e31f416ca05d" alt="AI Studio project panel showing the plus button used to add a new entity to the project" width="538" height="458" data-path="images/project-add.png" />
    </Frame>

    Projects use **Directories** to organize entities into a folder structure. Add a new directory using the <kbd><Icon icon="plus-large" /></kbd> button and selecting Directory. Add any number of sub-directories to fit the project structure.
  </Tab>

  <Tab title="New navigation (Feature Preview)">
    <Tip>
      If the top bar shows a project name dropdown (for example, **Default Project**), Sidebar V2 is already active. If not, follow the enable instructions below.
    </Tip>

    **Enable Sidebar V2**

    Open the workspace menu at the bottom left, select **Feature Preview**, and toggle **Sidebar V2** on.

    <Frame caption="Open Feature Preview from the workspace menu.">
      <img src="https://mintcdn.com/orqai/PmB2dfYcRDbvzd7F/images/sidebar-v2-feature-preview-menu.png?fit=max&auto=format&n=PmB2dfYcRDbvzd7F&q=85&s=a7086be0be5ad19c745ebf7cbe68dca4" alt="Workspace menu open at the bottom left, with Feature Preview option visible in the list" style={{ width:"70%" }} width="640" height="544" data-path="images/sidebar-v2-feature-preview-menu.png" />
    </Frame>

    <Frame caption="Toggle Sidebar V2 on in the Feature Preview panel.">
      <img src="https://mintcdn.com/orqai/PmB2dfYcRDbvzd7F/images/sidebar-v2-feature-preview-modal.png?fit=max&auto=format&n=PmB2dfYcRDbvzd7F&q=85&s=05dad1848296ea32bb03db634c1ba17e" alt="Feature Preview panel showing Sidebar V2 with an Off toggle and a preview of the redesigned sidebar layout" width="1374" height="945" data-path="images/sidebar-v2-feature-preview-modal.png" />
    </Frame>

    **Switching projects**

    Click the project name in the top bar to open the project dropdown. Search for a project, select one from the list, or click **Create New Project**.

    <Frame caption="Select or create a Project from the top bar dropdown.">
      <img src="https://mintcdn.com/orqai/PmB2dfYcRDbvzd7F/images/sidebar-v2-project-dropdown.png?fit=max&auto=format&n=PmB2dfYcRDbvzd7F&q=85&s=e3487e06ac644b68859d3100235e4c6d" alt="Project dropdown in Sidebar V2 showing All Projects, Default Project, TestProject, and a Create New Project option" width="721" height="574" data-path="images/sidebar-v2-project-dropdown.png" />
    </Frame>

    **Editing or deleting a project**

    Click the <kbd><Icon icon="ellipsis" /></kbd> menu next to a project name in the dropdown to **Edit** the project name or **Delete** the project.

    <Frame caption="Edit or delete a project from the project dropdown menu.">
      <img src="https://mintcdn.com/orqai/PmB2dfYcRDbvzd7F/images/docs/edit-delete-project-411.png?fit=max&auto=format&n=PmB2dfYcRDbvzd7F&q=85&s=108b3e14fcdba323a32af59133d13c59" alt="Project dropdown with the ellipsis menu open on a project row, showing Edit and Delete options" width="620" height="412" data-path="images/docs/edit-delete-project-411.png" />
    </Frame>

    <Note>
      A project can only be deleted if it's empty. Remove all entities from the project first.
    </Note>
  </Tab>
</Tabs>

## Browsing Projects

<Tabs>
  <Tab title="Default navigation">
    Click a Project Name to view all sub-folders and entities within the project, including when they were last modified and by which **Team Member**.

    <Frame caption="Click through project folders and sub-folders to browse to desired entities.">
      <img src="https://mintcdn.com/orqai/9ezrEik8zdClmQ3y/images/project-view.png?fit=max&auto=format&n=9ezrEik8zdClmQ3y&q=85&s=fbed9d4eae32bf3827461e3f5eefc54a" alt="Project directory view showing sub-folders and entity rows with last modified date and team member columns" title="Project View" style={{ width:"100%" }} width="1806" height="416" data-path="images/project-view.png" />
    </Frame>

    <Tip>
      Use filters to find a specific Entity Type. Use sorting to order by Name or Modified Date.
    </Tip>

    Use the <kbd><Icon icon="ellipsis" /></kbd> menu to:

    * **Move** an entity to a different folder.
    * **Delete** an entity.

    In the **Settings** tab:

    * **Update** the Project Name.
    * **Configure Human Reviews** on the Project (see [Human Review](/docs/ai-studio/observability/annotation-queues#create-human-review)).

    **Moving Entities and Folders**

    Reorganize projects at any time by moving entities and folders.

    Select the desired entity and choose <kbd className="key"><Icon icon="file-import" color="#fff" /> Move</kbd>. The following modal opens.

    <Frame caption="Browse through the desired projects and folders, create a new folder using + and choose destination for the selected entity using Move.">
      <img src="https://mintcdn.com/orqai/x_6IXnot9ETOc_0g/images/docs/8af04aa3913078676010f4a3f550ccc57720f80522db254fcd26a0d214907efe-Screenshot_2025-03-12_at_20.17.23.png?fit=max&auto=format&n=x_6IXnot9ETOc_0g&q=85&s=9bdf86228abbd7b2fe13ad1301c17a6c" alt="Move modal showing a folder browser with a plus button to create folders and a Move confirmation button" width="1592" height="940" data-path="images/docs/8af04aa3913078676010f4a3f550ccc57720f80522db254fcd26a0d214907efe-Screenshot_2025-03-12_at_20.17.23.png" />
    </Frame>
  </Tab>

  <Tab title="New navigation (Feature Preview)">
    Use **Directory** in the sidebar to view all entities in the current project. The breadcrumb shows which project is active.

    <Frame caption="Directory view showing all entities in the Default Project with last update date and team member.">
      <img src="https://mintcdn.com/orqai/PmB2dfYcRDbvzd7F/images/directory-sidebarv2-411.png?fit=max&auto=format&n=PmB2dfYcRDbvzd7F&q=85&s=35769442213f538283c2f4122cf0e97c" alt="Directory view listing all entity types in a flat list with Name, Last Update, and Updated by columns, plus Search, Filter, and Create controls" width="1411" height="716" data-path="images/directory-sidebarv2-411.png" />
    </Frame>

    The directory lists all entity types in a single flat view: **Evaluators**, **Deployments**, **Knowledge Bases**, **Experiments**, **Agents**, **Playgrounds**, and more. Use **Search** and **Filter** to narrow the list, or click <kbd>+ Create</kbd> to add a new entity directly from the directory.
  </Tab>
</Tabs>

## Permissions

When creating a project, assign which **Teams** have access. Each team has members with different access levels across the project entities.

<Frame caption="Choose which team to add to a Project.">
  <img src="https://mintcdn.com/orqai/iV1P61Ac2GbluSfe/images/create-projects-members.png?fit=max&auto=format&n=iV1P61Ac2GbluSfe&q=85&s=e0540fb0ff30a767e2cad94d3b10e6e2" alt="Project creation dialog showing a team selector with access level options" width="679" height="392" data-path="images/create-projects-members.png" />
</Frame>
