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

# Upload files and folders

Media Studio shows progress for each file in the transfer tray. Add more files
while a transfer runs, pause and resume a transfer, pause or resume the entire queue, or retry a failed one. Folder
uploads recreate the selected folder hierarchy in the current workspace. A file
appears in the library after Studio accepts it. Its thumbnail can finish later
when you use a [queue worker](https://studio.bjanczak.com/configuration.md#image-thumbnails-and-workers).

| Requirement | Guide |
| - | - |
| Send ordinary files or folders from Studio | [Browser uploads](#configure-uploads-in-the-browser) |
| Resume a large upload through the web app | [Resumable uploads through Laravel](https://studio.bjanczak.com/upload-resumable.md) |
| Send large parts straight to the object store | [Direct S3 multipart uploads](https://studio.bjanczak.com/upload-s3-multipart.md) |
| Save originals on S3 using any supported upload transport | [Private S3 storage](https://studio.bjanczak.com/storage-s3.md) |
| Accept files from people without a Studio account | [Guest uploads](https://studio.bjanczak.com/guest-uploads.md) |
| Implement a client or recover unfinished transfers | [Upload API](https://studio.bjanczak.com/upload-client-api.md) · [Upload recovery](https://studio.bjanczak.com/upload-recovery.md) |

## Configure uploads in the browser

```ts theme={null}
mountMediaStudio(container, {
    transport,
    upload: {
        enabled: true,
        allowFolders: true,
        showPanel: true,
        panelInitiallyExpanded: true,
        concurrency: 3,
        maxFiles: 500,
        maxRetainedCompleted: 100,
        progressIntervalMs: 100,
        chunkThresholdBytes: 8 * 1024 * 1024,
    },
});
```

The server applies its own limits even if the browser allows more. Set
`allowFolders: false` to remove folder selection from a particular instance.
The tray shows live progress for files selected in the current tab. After closing
or refreshing the page, the browser no longer has those local files. A paused
chunked transfer resumes by checking accepted parts with the server, including
S3 Multipart. A final publication already in progress is allowed to finish;
other files remain paused. An ordinary upload may restart its byte transfer,
using the same idempotency key.

## Upload in chunks through Laravel

[Continue to Resumable uploads through Laravel](https://studio.bjanczak.com/upload-resumable.md#upload-in-chunks-through-laravel).

## Upload directly to private S3

[Continue to Direct S3 multipart uploads](https://studio.bjanczak.com/upload-s3-multipart.md#upload-directly-to-private-s3).

## Schedule staging cleanup

[Continue to Upload recovery and cleanup](https://studio.bjanczak.com/upload-recovery.md#schedule-staging-cleanup).

## Use the upload API from your own client

[Continue to Upload API for custom clients](https://studio.bjanczak.com/upload-client-api.md#use-the-upload-api-from-your-own-client).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.