---
title: "Files, folders and links"
description: "Upload files and whole folders, add links, and move, rename or delete artifacts one at a time or in bulk."
---

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

# Files, folders and links

Add files, folders and links to a project's artifacts, then keep them tidy by moving, renaming and deleting. Everything happens on the project's **Artifacts** tab.

## Upload files and folders

The quickest way is to drag files or folders from your computer onto the page. The whole page takes drops, and a banner shows where they'll land. Drop onto a folder row, card or breadcrumb to upload straight into that folder.

You can also use the **New** menu:

1. Open the folder you want to upload into.
2. Click **New**.
3. Pick **Upload files** to choose one or more files, or **Upload folder** to choose a whole folder.

Uploading a folder keeps its structure, with every subfolder and file in place.

While files upload, a tray in the corner shows progress, such as **Uploading 3 of 12**. From the tray you can cancel one upload or all of them, and retry any that failed with **Retry all failed**.

### Limits

- Each file can be up to 100 MB. Bigger files are marked in the tray and skipped.
- You can drop up to 1,000 files at once.
- If something with the same name is already in the folder, the new one gets a number, for example `Contract (1).pdf`.

## Create a folder

1. Click **New**, then **New folder**.
2. Type a name over "Untitled folder" and press <kbd>Enter</kbd>.

Folder names can't contain `/`.

## Add a link

Save links to the places a project lives, such as its repository, design files or staging site.

1. Click **New**, then **Add a link**.
2. Paste the address, for example `https://github.com/acme/web`. It must start with `http://` or `https://`.
3. Optionally give it a **Title**. If you leave it empty, the link is named after its address.
4. Click **Add link**.

Clicking a link opens the site in a new tab. To change the address or title later, pick **Edit** from the link's **⋯** menu.

## Move artifacts

- **Drag and drop.** Drag a file, folder or link onto a folder to move it there. To move it up, drop it on the `..` row or on a breadcrumb. If you've selected several, dragging one moves them all.
- **Move to.** Pick **Move to** from an artifact's **⋯** menu, or select several and click **Move to** in the bar that appears, then choose the destination folder.

A folder can't move into itself. If the destination already has something with the same name, the moved one gets a number.

## Select several at once

Tick the checkbox on a row, or hold <kbd>⌘</kbd> and click. Hold <kbd>⇧</kbd> and click to select a range, or press <kbd>⌘</kbd> <kbd>A</kbd> to select everything shown. A bar shows how many are selected, with **Move to** and **Delete**. Press <kbd>Esc</kbd> to clear the selection.

## Rename

Pick **Rename** from the **⋯** menu, type the new name and press <kbd>Enter</kbd>, or <kbd>Esc</kbd> to cancel. Names must be unique within a folder.

## Delete

Pick **Delete** from the **⋯** menu, or select several and click **Delete** in the bar. Confirm in the dialog.

> **Deleting can't be undone**
>
> Deleted artifacts are gone for everyone. Deleting a folder also deletes everything inside it, and any shares or public links on them stop working.

## Other actions

The **⋯** menu on each artifact also has **Open**, **Download** for files, **Copy link** and **Share**. **Copy link** copies a link your teammates can open in Spool. For a saved link, it copies the link's own address.

## Related

- [Artifacts overview](https://spool.team/docs/artifacts/overview/)
- [Share artifacts](https://spool.team/docs/artifacts/sharing-artifacts/)

Source: https://spool.team/docs/artifacts/files-folders-and-links/index.mdx
