# Media library and storage

> The media library holds every image and video your workspace uploads, from the app, the API or an agent. The free plan includes 2 GB of storage, and after a wallet top-up you can go past it, paying for each extra GB from your wallet.

Source: https://voholabs.com/docs/workspace/media  
Last updated: 5 October 2026

Every file you attach to a post goes into the media library, so you can reuse it in later posts. Open it from **Media** in the menu, or from **Insert Media** in the composer.

## How do I upload media?

1. Choose **Media** in the menu.
2. Choose **Upload** and pick one or more files, or drag them onto the page.
3. The files appear in the library, newest first.

In the composer, choose **Insert Media**, then **Upload** in the **Media Library** window, or drop files onto the editor. Use **Search by file name** to find an older file.

## Which files and sizes are accepted?

| Type | Formats | Largest file in the app |
|---|---|---|
| Images | JPEG, PNG, GIF, WebP and other common formats | 30 MB |
| Video | MP4 | 1 GB |

Uploads through the [public API](https://voholabs.com/docs/api) or an agent accept images up to 10 MB and MP4 video up to 1 GB. Each network has its own limits on top of these, for example Facebook Page photos must be under 4 MB. See the [channels overview](https://voholabs.com/docs/channels#what-does-each-network-accept).

## How much storage do I have?

Storage belongs to the workspace and is the total size of the files in its media library.

- **Free plan**: 2 GB, with no card needed.
- **Free plan after a wallet top-up**: the first 2 GB stay free. Beyond that there is no fixed limit. Each started GB above the free amount is charged once from your wallet, when an upload first needs it.
- **Paid plans**: the storage that comes with the plan.

The current price per GB is on the live [prices page](https://studio.voholabs.com/pricing), under **Storage**.

## What happens when storage is full?

On the free plan without a top-up, an upload that would go over 2 GB is refused with: "Your media library is full. Delete files you no longer need, or upgrade for more storage."

To make room, either:

1. Delete files you no longer need, or
2. [Top up your wallet](https://voholabs.com/docs/billing/credits#how-do-i-top-up), so uploads past 2 GB are paid per GB.

After a top-up, an upload that needs a new GB is paid for before the file is stored. If your balance cannot cover it and auto top-up cannot refill it, the upload is refused with "Not enough credits to store this file. Top up to upload it." and nothing is charged.

## How do I delete media?

1. Choose **Media** in the menu.
2. Hover the file and click the delete mark in its corner.
3. Confirm when Studio asks.

Agents can delete media with the `deleteMediaTool`.

## Frequently asked questions

### Does deleting files give me credits back?

No. Deleting frees space, but a GB you have paid for stays paid for. New uploads fill that space again before another GB is charged.

### Is storage shared by my team?

Yes. Storage belongs to the workspace, so every member's uploads count towards the same total.

### What happens to my files if a paid plan ends?

The workspace returns to the free plan and its 2 GB limit. Files above it stay, but you cannot upload more until you are under the limit or have topped up your wallet.

### Can my agent upload files?

Yes. Agents upload through the MCP tools, from a file, a link or a public URL, into the same library. In Claude you need to allow Studio's file domains first. See [Connect Claude](https://voholabs.com/docs/agents/claude).

## Related pages

- [Create a post](https://voholabs.com/docs/posts/create)
- [Credits and wallet](https://voholabs.com/docs/billing/credits)
- [Plans and billing](https://voholabs.com/docs/billing)
- [Troubleshooting](https://voholabs.com/docs/help/troubleshooting)