# Upload and organize Assets

> Upload files to Nodespell from the Asset Manager, the graph or a node's asset picker, then organize Assets with folders, tags, renaming and moving.

Source: https://docs.nodespell.com/assets/upload-and-organize/ · Last updated: 2026-11-10

Uploading in Nodespell turns a file from your computer into an Asset: a stored file you can reuse in any Project in the same workspace. You can upload from the Asset Manager, by dropping files onto the graph, or from a node's asset picker. Each file can be up to 200 MB, and you can upload up to 50 files at a time.

## Upload limits at a glance

| Limit                   | Value                                                                                                      |
| ----------------------- | ---------------------------------------------------------------------------------------------------------- |
| Size per file           | 200 MB (larger files are refused with **Files too big, limit is 200MB**)                                   |
| Files per upload        | 50 (more are refused with **Too many files, limit is 50**)                                                 |
| Files uploading at once | 3; the rest wait as **Queued**                                                                             |
| Storage                 | Your workspace's allowance; see [Workspaces and storage](https://docs.nodespell.com/assets/workspaces-and-storage/)                  |
| Accepted types          | Images, video, audio, documents, archives and 3D files; see [Supported media](https://docs.nodespell.com/reference/supported-media/) |

## Upload from the Asset Manager

1. Open the [Asset Manager](https://docs.nodespell.com/assets/asset-manager/) and choose the workspace and folder you want.
2. Select **Upload** and choose files.
3. In the upload dialog, check the destination. It shows the workspace, the folder and **Storage charged to**. Pick another folder under **Upload location**, or select **Create New Folder**.
4. Select **Upload Assets**.

Each file shows its status: **Queued**, **Uploading**, **Uploaded**, **Reused** or **Failed**. A failed file shows the reason; select **Retry** on it, or **Retry failed** for all of them. **Remove file** takes a file out of the queue before it uploads. The default destination is the **Uploads** folder.

A folder you create in the upload dialog is temporary until a file is uploaded into it. Its name can use letters, numbers, spaces, hyphens and underscores.

## Upload by dropping files on the graph

Drag files from your computer onto the Graph canvas. The upload dialog opens so you can choose the folder. When the upload finishes, Nodespell creates an Asset node for each file where you dropped them. Files over the limits, or of a type Nodespell does not recognize, are refused with **Unsupported file types** and the file names.

You can also press `O` with the pointer over the canvas to open **Add asset**, then choose **Assets** (pick from your library), **Upload** (choose files), or **Load from URL** (paste a direct link to create an Asset node).

Dropping a link creates an Asset node that points to that link; the file is not uploaded to your Assets.

## Upload from a node's asset picker

When a node parameter asks for media, select **Choose assets**. The picker lets you choose existing Assets, upload files with **Choose files**, or add a public external URL. Uploaded files become Assets in the Project's workspace.

## What happens when I upload the same file twice?

Nodespell recognizes identical file content in the same workspace. Instead of storing a second copy, the upload reports **Reused**, and the Asset Manager reveals the existing Asset in its current folder. The message reads, for example, **Reused 1 existing Asset**. A reused file does not use extra storage. Identical files in a different workspace (Personal and a Team) are separate Assets.

## Organize with folders

| Action          | How                                                                                      |
| --------------- | ---------------------------------------------------------------------------------------- |
| Create a folder | **New folder** for the top level, or **Create subfolder** from a folder's actions        |
| Rename a folder | **Rename folder**. Assets keep their files; only the Asset Manager organization changes. |
| Move a folder   | **Move folder**, then choose a destination or **Top level**                              |
| Delete a folder | **Delete folder**. Only folders with no Assets and no child folders can be deleted.      |
| Move Assets     | Select Assets, right-click, **Move to folder…**, choose the destination, **Move Assets** |

Moving Assets only changes their folder inside the current workspace. It never changes who owns them or which storage they count against. To put an Asset in another workspace, copy it; see [Workspaces and storage](https://docs.nodespell.com/assets/workspaces-and-storage/).

## Organize with tags

Tags let one Asset appear in several groupings. Nest tags with a slash, for example `client/acme`.

- Select Assets, right-click and choose **Manage Tags**. Use **Add tag**, or type in **Search or create tags...** and choose **Create "…"**.
- In the **Inspector**, type in **Add tag...** and select **Add**, or remove a tag from the list.
- Switch **Browse by** to **Tags** to browse by tag. Each tag's options are **Rename**, **Color**, **Merge** and **Delete**.

**Merge** moves every Asset tagged with one tag to another and previews how many Assets change. **Delete** removes the tag from every Asset; **Delete with children** also removes nested tags. Deleting a tag never deletes Assets.

## Rename or replace an Asset

- **Rename**: right-click one Asset, choose **Rename**, and type the new name including the extension.
- **Replace Asset**: right-click, choose **Replace Asset**, and pick a new file. In a Team, only the uploader or the Team owner can replace an Asset.

## Put Assets on the graph

Drag Assets from the Asset Manager onto the Graph canvas to create Asset nodes, or onto a [Timeline](https://docs.nodespell.com/edit/timeline/)'s Media area. See [Add nodes](https://docs.nodespell.com/graph/add-nodes/).

## Frequently asked questions

### Can I paste an image from the clipboard to upload it?

Not into the Asset Manager or the graph. Use **Upload**, drag files onto the graph, or the asset picker. The [Agent](https://docs.nodespell.com/agent/context-and-references/) composer accepts pasted files as attachments.

### Why did my upload say Reused instead of Uploaded?

The same file content already exists in this workspace. Nodespell points you to the existing Asset instead of storing a duplicate.

### Why was my upload refused for storage?

The workspace has less free storage than the files need. See [Workspaces and storage](https://docs.nodespell.com/assets/workspaces-and-storage/) for how to free space.

### Can I upload a folder of files?

Select the files inside the folder; you can choose up to 50 at a time.

## Related

- [Asset Manager](https://docs.nodespell.com/assets/asset-manager/): browse, search and inspect Assets
- [Preview, download and Trash](https://docs.nodespell.com/assets/preview-download-and-trash/): what to do with Assets after upload
- [Workspaces and storage](https://docs.nodespell.com/assets/workspaces-and-storage/): Personal and Team storage
- [Supported media](https://docs.nodespell.com/reference/supported-media/): accepted file types
- [Add nodes](https://docs.nodespell.com/graph/add-nodes/): use Assets in a graph