> ## 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.

# Recording Projects

> Organize recordings and links by assigning them to projects

Projects help you organize recordings and links into logical groups. Every recording link is assigned to a project, and the resulting recording inherits that assignment.

## Assigning a project

When you [create a recording link](/recording/requesting), select a **project** from the dropdown. If you don't choose one, the link is assigned to the workspace's **default project**.

<Steps>
  <Step title="Open the Create Link dialog">
    Click the [Create Link](https://dash.userplane.io/_/recordings?create_link=true) button in the top right corner.

    <Frame caption="Create Link button">
      <img src="https://mintcdn.com/userplane/iHJrxtyvOmNXmfMS/media/links/create-link/create-link-unfilled.png?fit=max&auto=format&n=iHJrxtyvOmNXmfMS&q=85&s=ddb807aad47446a99a906f2197e44000" width="1920" height="958" data-path="media/links/create-link/create-link-unfilled.png" />
    </Frame>
  </Step>

  <Step title="Select a project">
    Choose which project this recording belongs to from the **Project** dropdown.

    <Frame caption="Click show advanced options">
      <img src="https://mintcdn.com/userplane/iHJrxtyvOmNXmfMS/media/links/create-link/create-link.png?fit=max&auto=format&n=iHJrxtyvOmNXmfMS&q=85&s=0a6dbc96efbe445bab7da6fdba353551" width="1920" height="958" data-path="media/links/create-link/create-link.png" />
    </Frame>

    <Frame caption="Pick a project from the dropdown">
      <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>
  </Step>

  <Step title="Create the link">
    Fill in the remaining details and click **Create**. The recording link inherits the selected project.
  </Step>
</Steps>

## How projects help

* **Filter recordings** — on the Recordings page, filter by project to see only the recordings that matter.

  <Frame caption="Project recordings view">
    <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>

* **Filter links** — on the Links page, filter by project to find related links.

  <Frame caption="Filtering project recordings">
    <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>

* **Project views** — switch to a project-scoped view to see all recordings and links for a specific project.

  <Frame caption="Recording link in project view">
    <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>

* **Team organization** — use projects to separate recordings by product area, team, or customer segment.

## Managing projects

Projects are managed from [Workspace Settings > Projects](https://dash.userplane.io/_/settings?tab=general). See [Projects](/workspace/projects) for details on creating, editing, and deleting projects.

<Steps>
  <Step title="View your projects">
    Open [Workspace Settings > Projects](https://dash.userplane.io/_/settings?tab=general) to see all projects in your workspace.

    <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="Create a new project">
    Click **Create Project** and enter a name for the project.

    <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>

  <Step title="Edit a project">
    Click the menu on any project to edit its name or configure retention settings.

    <Frame caption="Project 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>

    <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="View advanced options">
      <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">
    Set a retention policy to automatically expire recordings after a specified period.

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

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

    <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>

## Default project

Every workspace has a default project that cannot be deleted. Links created without an explicit project selection are assigned to the default project.

## Related articles

* [Projects](/workspace/projects) — creating and using projects.
* [Project Lifecycle](/workspace/project-lifecycle) — delete and restore projects.
* [Recording Expiry](/recording/expiry) — manually set expiration dates for individual recordings.