vercel blob

The vercel blob command is used to interact with Vercel Blob storage, providing functionality to upload, download, list, delete, and copy files in public and private stores, 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
• get - Download a blob from the Blob store
• create-store - Create a new Blob store
• delete-store - Delete a Blob store
• get-store - 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 get [url-or-pathname]

vercel blob create-store [name] [--access <access>] [--region <region>]

vercel blob delete-store [store-id]

vercel blob get-store [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 --allow-overwrite option to overwrite the file if it already exists when uploading. The default is false.

vercel blob put image.jpg --allow-overwrite

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 create-store command.

vercel blob create-store my-store --region sfo1

You can use the --access option to specify whether the store or blob should use public or private storage. The default is public. This option applies to the put, copy, get, and create-store commands.

vercel blob put image.jpg --access private

You can use the --output option to save the blob content to a file instead of printing it to stdout. This option only applies to the get command.

vercel blob get image.jpg --output ./local-image.jpg

You can use the --if-match option to only perform the operation if the blob's ETag matches the provided value. This option applies to the put, del, and copy commands.

vercel blob put image.jpg --if-match "etag-value"

You can use the --if-none-match option to only return content if the blob's ETag does not match the provided value. If unchanged, the server returns a 304 response. This option applies to the get command.

vercel blob get image.jpg --if-none-match "etag-value"

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.