# Trash

> Restore deleted documents, uploads, and folders within 30 days, or permanently delete them from Trash.

Source: https://hyperclay.com/docs/trash/

Deleting a document, uploaded file, or folder in Hyperclay moves it to **Trash** instead of erasing it immediately. Items stay in **Trash** for 30 days so you can restore them if you change your mind.

## What goes to Trash

When you delete a document, upload, or folder from your workspace, it moves to **Trash**. To open **Trash**, click **Account menu** (**My account**) and choose **Trash**.

- Deleting a folder moves the folder and everything inside it to **Trash** together as one unit.
- Items in **Trash** cannot be opened until you restore them, and they are left out of [search](https://hyperclay.com/docs/search/) and [workspace exports](https://hyperclay.com/docs/import-export/).
- The **Deleted items** table lists each item's **Name** and **Deleted** date.

## How long items stay in Trash

Items remain in **Trash** for 30 days (**Files in Trash are deleted for good after 30 days.**). After 30 days in **Trash**, a daily cleanup permanently deletes expired items along with their [version history](https://hyperclay.com/docs/version-history/).

## Restore from Trash

1. Open **Account menu** and click **Trash**.
2. Click **Restore** on the row you want to recover.
3. Confirm in the **Restore `<name>`** dialog.

When you restore an item:

- It returns to its original folder. Restoring a folder puts back the folder and everything that was deleted with it.
- If its original folder no longer exists, the item returns to **Home** at the root of your workspace.
- If another item in that folder now has the same name, the restored item is renamed `<name>-restored` (or `-restored-2`, and so on).
- If a trashed document had a custom domain or claimed subdomain, you must reconnect the custom domain or claim the subdomain again (if still available) after restoring; see [Addresses and subdomains](https://hyperclay.com/docs/addresses/) and [Custom domains](https://hyperclay.com/docs/custom-domains/).

Items are restored one row at a time. If a row's underlying file bytes are unavailable, the row shows **Files unavailable** and **Restore** is disabled.

## Delete forever or empty Trash

> [!WARNING]
> Permanently deleting an item also destroys its entire [version history](https://hyperclay.com/docs/version-history/). Deleted items and their recoverable history cannot be restored after this action.

You can permanently erase items from **Trash** in three ways:

- **Single item**: Click **Delete permanently** on the item's row and confirm in the **Delete `<name>` permanently** dialog.
- **Selected items**: Tick the checkboxes next to the items you want to remove, click **Delete selected** in the bulk bar, and confirm in the **Delete `<N>` selected items permanently?** dialog.
- **All items**: Click **Empty Trash** in the page header and confirm in the **Empty Trash permanently** dialog.

## Who can use Trash

- **Account owners**: Can open **Trash**, **Restore** items, **Delete permanently**, **Delete selected**, and **Empty Trash**.
- **Team editors**: Can open **Trash** and **Restore** items, but cannot permanently delete items or empty **Trash** (the permanent delete and **Empty Trash** controls are hidden).
- **Team viewers**: Cannot open or use **Trash**.
