Storage Upload | Metaplex CLI

Summary

The mplx toolbox storage upload command uploads a single file or a whole directory to the configured storage provider.

Uploads one file by default, or every file under a directory with --directory.
Directory uploads produce an uploadCache.json mapping each file to its URI.
Auto-funds the storage account if the balance is insufficient.
Returns the URI(s) and MIME type of the uploaded content.

The table below summarizes the command's inputs, flags, and side effects.

Item	Value
Command	`mplx toolbox storage upload <path> [--directory]`
Required arg	`path` — file path, or directory path with `--directory`
Optional flag	`--directory`
Directory output	Writes `uploadCache.json` in the current directory
Provider	Active storage provider (e.g. Irys)

Pass a file path to upload a single file, or add --directory to upload every file in a directory.

# Upload a single file
mplx toolbox storage upload <path>

# Upload every file in a directory
mplx toolbox storage upload <directory> --directory

The single positional argument is the path being uploaded.

path (required): Path to a file, or path to a directory when combined with --directory.

The optional flag switches to directory mode.

These examples show a single-file and a directory upload.

mplx toolbox storage upload ./metadata.json
mplx toolbox storage upload ./assets --directory

Single-file uploads print the resulting URI. Directory uploads report the count and the cache file path.

Single file:

--------------------------------
    Uploaded <path>
    URI: <uri>
---------------------------------

Directory:

--------------------------------
    Successfully uploaded <N> files

    Upload cache saved to uploadCache.json
---------------------------------

Storage is funded and billed through the active storage provider. If your storage balance is low, the command will automatically fund it before upload.
Check your storage balance with toolbox storage balance.
Fund the storage account with toolbox storage fund.