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

# Projects

> Organize recordings and links into projects for easier management

Projects are a way to organize your recordings and links into logical groups. You might create a project for each product area, team, or customer segment.

## What projects are

A project is a named container within your workspace. Every recording link is assigned to a project, and the recording it produces inherits that assignment. This lets you filter, browse, and manage recordings by project.

<Frame caption="Project recordings">
  <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/projects/view/view-recordings.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=11374592dfef2f2111d1a4a25c0c6fd1" width="1920" height="958" data-path="media/projects/view/view-recordings.png" />
</Frame>

## Default project

Every workspace has a **default project** that is created automatically. The default project cannot be deleted. Recording links created without specifying a project are assigned to the default project.

## Creating a project

<Steps>
  <Step title="Open Projects settings">
    Go to [Workspace Settings > Projects](https://dash.userplane.io/_/settings?tab=general).

    <Frame caption="Projects list">
      <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/projects/projects-list.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=400466947ba378d948878187af4d9bd4" width="1342" height="906" data-path="media/projects/projects-list.png" />
    </Frame>
  </Step>

  <Step title="Click Create Project">
    Click **Create Project** to open the creation dialog.

    <Frame caption="Projects list">
      <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/projects/view-projects.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=2fbeb48292a8117efdd624a3582c60fc" width="1920" height="958" data-path="media/workspace/projects/view-projects.png" />
    </Frame>
  </Step>

  <Step title="Enter a name and save">
    Enter a name for the project and click **Save**.

    <Frame caption="Create project dialog">
      <img src="https://mintcdn.com/userplane/iHJrxtyvOmNXmfMS/media/projects/create-project-dialog.png?fit=max&auto=format&n=iHJrxtyvOmNXmfMS&q=85&s=dde237429ed1268e4c8da83e0b8db83b" width="2940" height="1596" data-path="media/projects/create-project-dialog.png" />
    </Frame>
  </Step>
</Steps>

## Editing a project

<Steps>
  <Step title="Open the project menu">
    Find the project in the list and click the menu icon.

    <Frame caption="Project actions menu">
      <img src="https://mintcdn.com/userplane/iHJrxtyvOmNXmfMS/media/projects/project-menu.png?fit=max&auto=format&n=iHJrxtyvOmNXmfMS&q=85&s=159152e399f7c70ae20c0190d83e9653" width="1342" height="906" data-path="media/projects/project-menu.png" />
    </Frame>
  </Step>

  <Step title="Edit project details">
    Update the project name or other settings.

    <Frame caption="Edit project">
      <img src="https://mintcdn.com/userplane/iHJrxtyvOmNXmfMS/media/projects/edit-project.png?fit=max&auto=format&n=iHJrxtyvOmNXmfMS&q=85&s=000b4a402f886b138b6ac1b59a09be81" width="1342" height="906" data-path="media/projects/edit-project.png" />
    </Frame>

    <Frame caption="Edit project">
      <img src="https://mintcdn.com/userplane/iHJrxtyvOmNXmfMS/media/projects/manage/edit-project.png?fit=max&auto=format&n=iHJrxtyvOmNXmfMS&q=85&s=46b0c862495d6c7044626ff564be9643" width="1920" height="958" data-path="media/projects/manage/edit-project.png" />
    </Frame>
  </Step>

  <Step title="Configure retention (optional)">
    Set a retention policy to automatically expire recordings after a specified period.

    <Frame caption="Configure retention">
      <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/workspace/projects/configure-retention.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=df0cf579b3363173569b175014928659" width="1920" height="957" data-path="media/workspace/projects/configure-retention.png" />
    </Frame>
  </Step>
</Steps>

## Using projects

<Tabs>
  <Tab title="When creating links">
    Select a project from the **Project** dropdown when [creating a recording link](/recording/requesting). The resulting recording inherits the project assignment, making it easy to find later.

    <Frame caption="Project selection in create link form">
      <img src="https://mintcdn.com/userplane/iHJrxtyvOmNXmfMS/media/links/create-link/create-link-project-selection.png?fit=max&auto=format&n=iHJrxtyvOmNXmfMS&q=85&s=0196f54a3e06fca2fd8e614e23d70ffa" width="1920" height="958" data-path="media/links/create-link/create-link-project-selection.png" />
    </Frame>

    See [Recording Projects](/recording/projects) for a full walkthrough.
  </Tab>

  <Tab title="When reviewing recordings">
    Filter by project on the [Recordings](/recording/reviewing) page to narrow down to only the recordings that matter. You can also filter by project on the [Links](/recording-links/managing) page to find related links.

    <Frame caption="Filter recordings by project">
      <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/recordings/list-recording/filter-recording-by-project.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=52fd596525b2c8ed67ef44797a9d4d64" width="1920" height="957" data-path="media/recordings/list-recording/filter-recording-by-project.png" />
    </Frame>

    <Frame caption="Filter recordings by project">
      <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/recordings/recordings-project-filter.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=dfc4fcf6b451b45aa50fef5aba330381" width="1342" height="906" data-path="media/recordings/recordings-project-filter.png" />
    </Frame>
  </Tab>
</Tabs>

## Using project views

Switch to a project-scoped view for a focused look at a single project's recordings and links. The project view shows all recordings captured under that project, with filters to narrow down results and quick access to individual recording links.

<Frame caption="Filter recordings within a project">
  <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/projects/view/view-recordings-filter.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=f74d706135370ee93930783089f1a40e" width="1920" height="957" data-path="media/projects/view/view-recordings-filter.png" />
</Frame>

<Frame caption="View a recording link from a project">
  <img src="https://mintcdn.com/userplane/IKCB4f_KBaL0xsjW/media/projects/view/view-recording-link.png?fit=max&auto=format&n=IKCB4f_KBaL0xsjW&q=85&s=f6c3eb3d7c8d881d9dc8947e44d2ca35" width="1920" height="958" data-path="media/projects/view/view-recording-link.png" />
</Frame>

## Related articles

* [Project Lifecycle](/workspace/project-lifecycle) — deleting and restoring projects.
* [Recording Projects](/recording/projects) — how projects work with recording links.