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

# Organize diagrams

> Create, import, find, favorite, and recover diagrams in a workspace.

A workspace contains folders and diagrams. The active workspace determines where new files, imported files, templates, and AI-generated diagrams are stored.

## Create or import a diagram

You can start in three ways:

* Select **New diagram** for a blank canvas.
* Select **AI generate** to create a diagram from a prompt.
* Select **Import diagram** to upload a `.drawio` or `.xml` file.

Imported files must contain a valid draw\.io document and be no larger than 5 MB. DiagramAI uses the file name as the initial diagram title.

<Warning>
  Import rejects empty files, unsupported extensions, unsafe document markup, and XML that is not a
  draw\.io document.
</Warning>

## Use folders

* Create a folder at the workspace root or inside another folder.
* Open a folder before creating or importing a diagram to store it there.
* Use the breadcrumb to return to a parent folder.
* Deleting a folder moves its diagrams into trash.

## Find diagrams

The workspace provides:

* Search by diagram title
* Filters for folders and diagram types
* Sorting by updated time, created time, name, or type
* Grid and list views
* **Recent** for recently opened or edited diagrams
* **Favorites** for diagrams you want to reach quickly

## Use a template

Open **Templates**, preview an official template, and select **Use template**. DiagramAI copies the template into the active workspace so you can edit it without changing the original.

## Delete and restore

Deleting a diagram moves it to trash. From trash, you can:

* Restore one or more diagrams
* Permanently delete one or more diagrams

<Warning>
  Permanent deletion cannot be undone. In team workspaces, only Owners and Admins can permanently
  delete diagrams.
</Warning>

Files in trash still count toward the workspace file limit.

| Plan     | File limit |
| -------- | ---------: |
| Free     |         10 |
| Pro      |      1,000 |
| Business |    100,000 |

If you reach the limit, restore and keep only the files you need, permanently delete files from trash, or change your plan.