{
  "slug": "vercel-blob-put-image-stores-optimized-image-output-b4c02f5ad6cb",
  "title": "vercel blob put-image stores optimized image output",
  "tools": [
    "vercel"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-08-12T22:30:46.750Z",
  "announced_at": "2026-08-12T22:30:46.750Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When you need to store a transformed local image or public HTTP(S) image URL in Vercel Blob, run `vercel blob put-image` with `--width` and `--pathname`. The command stores the optimized output and prints its URL; use `--json` for the full blob object.",
    "examples": [
      "vercel blob put-image <file-or-url> --pathname <pathname> --width <width> --access <public|private>",
      "vercel blob put-image <file-or-url> --pathname <pathname> --width <width> --quality <1-100> --format <jpeg|png|webp|avif> --access <public|private> --json"
    ],
    "gotchas": [
      "Version: 58.10.0",
      "<file-or-url> (required): Local image path or public HTTP(S) URL to optimize.",
      "--width <width> (required): Output width in pixels (1–8192); preserves aspect ratio.",
      "--pathname <pathname> (required): Pathname where the optimized output is stored.",
      "--quality <1-100>: Optimized image quality; defaults to 75.",
      "--format <jpeg|png|webp|avif>: Output format; omitted preserves the source format.",
      "--access <public|private> (required): Select the blob's storage access mode.",
      "--json: Print full blob object, including URL, download URL, pathname and content type.",
      "--oidc-token and --store-id: Provide OIDC credentials; alternatively set VERCEL_OIDC_TOKEN and BLOB_STORE_ID. Read-write tokens are not accepted.",
      "Prerequisite: Requires OIDC credentials: pass --oidc-token and --store-id, or set VERCEL_OIDC_TOKEN and BLOB_STORE_ID. A linked project with a connected Blob store populates these automatically; `vercel env pull` can make them available in `.env.local`.",
      "Source must be a local file or public http(s) URL.",
      "`--width` and `--pathname` are required; `--quality` defaults to 75.",
      "Supported formats are jpeg, png, webp and avif; when `--format` is omitted, the original is preserved.",
      "Requires OIDC credentials using either the stated flag pair or environment variable pair.",
      "Stored content type comes from the optimizer output; there is no `--content-type` flag.",
      "Uses the `putImage` method from `@vercel/blob` 2.8.0.",
      "The command warns when the optimizer keeps the original image because optimized output would have been larger.",
      "Docs conflict: Current Vercel CLI docs say `--access` is required for `put-image`, but the supplied release note does not mention this flag; the documented runnable command includes it.",
      "Docs conflict: The current docs describe output format preservation as preserving the source image format, while the release note says the original is preserved when `--format` is omitted. They appear consistent; no conflict recorded."
    ]
  },
  "why_it_matters": "When storing a locally available image or a public image URL in Vercel Blob, create a transformed image at the required pathname.",
  "sources": [
    "https://github.com/vercel/vercel/blob/main/packages/cli/CHANGELOG.md#58100",
    "https://vercel.com/docs/cli/blob"
  ],
  "rank": 0.97029,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "vercel-20261007",
    "verdict_id": "vercel-20261007:vercel-20261007-2d99857d04121f6d-0:gate",
    "evidence_hash": "0264a2cb1e231f3f63200d51f264adfc0e01518fa2e7e544fadf09601db3e26c"
  },
  "review": {
    "draft_hash": "b6f4fa7d4cbaa01ca6c298e9cc187ff0b4704d5987c0ca7ed177e0863c0fe44e",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "vercel-20261007:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.97 >= 0.9; 2 needed) and Jev gave 0.80 (>= 0.6 needed)."
  }
}