Menu
Important
Stay updated on React2Shell
Click here

vercel blob

Last updated August 13, 2025

The command is used to interact with Vercel Blob storage, providing functionality to upload, list, delete, and copy files, as well as manage Blob stores.

For more information about Vercel Blob, see the Vercel Blob documentation and Vercel Blob SDK reference.

Usage

The command supports the following operations:

  • - List all files in the Blob store
  • - Upload a file to the Blob store
  • - Delete a file from the Blob store
  • - Copy a file in the Blob store
  • - Add a new Blob store
  • - Remove a Blob store
  • - Get a Blob store

For authentication, the CLI reads the value from your env file or you can use the option.

list (ls)

Using the vercel blob list command to list all files in the Blob store.

put

Using the vercel blob put command to upload a file to the Blob store.

del

Using the vercel blob del command to delete a file from the Blob store.

copy (cp)

Using the vercel blob copy command to copy a file in the Blob store.

store add

Using the vercel blob store add command to add a new Blob store. The default region is set to when not specified.

store remove (rm)

Using the vercel blob store remove command to remove a Blob store.

store get

Using the vercel blob store get command to get a Blob store.

Unique Options

These are options that only apply to the command.

Rw token

You can use the option to specify your Blob read-write token.

Using the vercel blob put command with the --rw-token option.

Limit

You can use the option to specify the number of results to return per page when using . The default value is and the maximum is .

Using the vercel blob list command with the --limit option.

Cursor

You can use the option to specify the cursor from a previous page to start listing from.

Using the vercel blob list command with the --cursor option.

Prefix

You can use the option to filter Blobs by a specific prefix.

Using the vercel blob list command with the --prefix option.

Mode

You can use the option to filter Blobs by either folded or expanded mode. The default is .

Using the vercel blob list command with the --mode option.

Add Random Suffix

You can use the option to add a random suffix to the file name when using or .

Using the vercel blob put command with the --add-random-suffix option.

Pathname

You can use the option to specify the pathname to upload the file to. The default is the filename.

Using the vercel blob put command with the --pathname option.

Content Type

You can use the option to overwrite the content-type when using or . It will be inferred from the file extension if not provided.

Using the vercel blob put command with the --content-type option.

Cache Control Max Age

You can use the option to set the of the cache-control header directive when using or . The default is (30 days).

Using the vercel blob put command with the --cache-control-max-age option.

Force

You can use the option to overwrite the file if it already exists when uploading. The default is .

Using the vercel blob put command with the --force option.

Multipart

You can use the option to upload the file in multiple small chunks for performance and reliability. The default is .

Using the vercel blob put command with the --multipart option.

Region

You can use the option to specify the region where your Blob store should be created. The default is . This option is only applicable when using the command.

Using the command with the option.

Global Options

The following global options can be passed when using the vercel blob command:

For more information on global options and their usage, refer to the options section.

Was this helpful?

supported.