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

# Folders

> Organize your tables into folders within your workspace.

As your workspace grows, folders help you keep tables organized and easy to find. You can group tables by project, client, pipeline stage, or any structure that fits your workflow.

<Frame>
  <video autoPlay muted loop playsInline controls>
    <source src="https://mintcdn.com/databar/EzPj4qSeM_hGoWFm/images/product-guide/how-folders-work.mp4?fit=max&auto=format&n=EzPj4qSeM_hGoWFm&q=85&s=e9621dbef086535a135ce2715120c27c" type="video/mp4" data-path="images/product-guide/how-folders-work.mp4" />
  </video>
</Frame>

## Creating a folder

1. From your workspace home, click the **folder icon** button in the top-right corner of the page.
2. Enter a name for your folder.
3. The folder appears in your workspace alongside your tables.

## Moving tables into a folder

1. On the workspace home, use the **checkboxes** on the left side of your tables to select one or more tables.
2. Click **Move to folder** in the action bar that appears.
3. Choose the destination folder.

To move a table back out, open the folder, select the table with its checkbox, and move it to the workspace root.

## Renaming a folder

1. Open the folder by clicking on it.
2. Click the folder name at the top of the page to edit it.
3. Type the new name and confirm.

## Deleting a folder

Select a folder using the **checkbox** on the left, then click **Delete** in the action bar that appears. Tables inside the folder are moved back to the workspace root. They are not deleted.

<Warning>
  Deleting a folder cannot be undone. Make sure you no longer need the organizational structure before removing it.
</Warning>

## Organization tips

| Strategy          | When to use                                                                     |
| ----------------- | ------------------------------------------------------------------------------- |
| By project        | When you have distinct initiatives with their own datasets                      |
| By client         | When managing data for multiple clients or accounts                             |
| By pipeline stage | When tables represent steps in a process (e.g., Raw leads, Enriched, Qualified) |
| By team           | When multiple people share a workspace and need clear ownership                 |

<Tip>
  Keep folder names short and consistent. A naming convention like `[Client] - [Project]` or `[Stage] - [Description]` makes it easy to scan at a glance.
</Tip>

## API access

You can also manage folders programmatically:

<CardGroup cols={2}>
  <Card title="List folders" icon="folder" href="/api-reference/endpoint/folders-list">
    Retrieve all folders in your workspace
  </Card>

  <Card title="Create folder" icon="folder-plus" href="/api-reference/endpoint/folders-create">
    Create a new folder via the API
  </Card>
</CardGroup>