vercel blob

The vercel blob 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.

The vercel blob command supports the following operations:

• list - List all files in the Blob store
• put - Upload a file to the Blob store
• del - Delete a file from the Blob store
• copy - Copy a file in the Blob store
• store add - Add a new Blob store
• store remove - Remove a Blob store
• store get - Get a Blob store

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

vercel blob list

vercel blob put [path-to-file]

vercel blob del [url-or-pathname]

vercel blob copy [from-url-or-pathname] [to-pathname]

vercel blob store add [name] [--region <region>]

vercel blob store remove [store-id]

vercel blob store get [store-id]

These are options that only apply to the vercel blob command.

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

vercel blob put image.jpg --rw-token [rw-token]

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

vercel blob list --limit 100

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

vercel blob list --cursor [cursor-value]

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

vercel blob list --prefix images/

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

vercel blob list --mode folded

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

vercel blob put image.jpg --add-random-suffix

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

vercel blob put image.jpg --pathname assets/images/hero.jpg

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

vercel blob put data.txt --content-type application/json

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

vercel blob put image.jpg --cache-control-max-age 86400

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

vercel blob put image.jpg --force

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

vercel blob put large-file.zip --multipart false

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

vercel blob store add my-store --region sfo1

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

• --cwd
• --debug
• --global-config
• --help
• --local-config
• --no-color
• --scope
• --token

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