---
title: "Folders and search"
description: "Keep documents in folders, inside each other, and find any document by name with one search."
source: "https://www.cloudpdf.com/docs/platform/documents/folders"
---

# Folders and search

Folders keep a workspace in order: one per client, per project, per year. Click **New folder**,
name it, and drop documents in, or upload straight into it.

![The Clients folder, with its two documents and the path back to Documents above](https://www.cloudpdf.com/docs/platform/folder.png)

The path above the list takes you back up. Folders hold folders too, up to 100 levels deep.

Two folders side by side can't have the same name, whatever the capitals. A folder's menu has
**Rename**, **Move to…** and **Delete**. Deleting a folder with documents in it deletes them too,
and their grants, so the dashboard asks first.

## Find a document

**Search all documents** looks through every folder at once, for documents and folders whose name
contains what you type:

![Searching for 2026: the matching documents, from the top level and the Finance folder](https://www.cloudpdf.com/docs/platform/search.png)

## Sort and view

Sort by **Newest first**, **Oldest first**, **Name, A to Z**, **Name, Z to A**, **Largest first**
or **Smallest first**. Switch between the list and a grid of thumbnails. Your browser remembers
both.

## In code

```ts
const { folder } = await cloudpdf.folders.create({
  tenantId,
  name: 'Clients',
  parentId: 'root',
});

await cloudpdf.uploads.create({
  tenantId,
  source: file,
  folderId: folder.id,
});

const { documents } = await cloudpdf.documents.list({
  tenantId,
  q: 'report',
});
```

- [Uploading](https://www.cloudpdf.com/docs/platform/documents/uploading.md) — Add PDFs, rename, move and delete them.
- [Grants](https://www.cloudpdf.com/docs/platform/grants.md) — Send a document as a link, or put it on your website.
