NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #4794 most downloaded on npm
Latest stable
15.3.0
Last release 14 days ago
05 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
511 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
238543c: Support Python services that declare their web app and development workflow sidecars through a pyproject.toml entrypoint in vercel dev.
pyproject.toml entrypoint in vercel dev.BREAKING CHANGE (@vercel/client): the agent?: http.Agent option was replaced with dispatcher?: FetchDispatcher (an undici dispatcher, e.g. undici.Prox…
def07fc: Migrate @vercel/client and @vercel/build-utils from node-fetch to native fetch. This removes the last url.parse() usage from the CLI bundle, which triggered a DEP0169 DeprecationWarning on Node 24 (visible in the standalone binary during vercel deploy).
BREAKING CHANGE (@vercel/client): the agent?: http.Agent option was replaced with dispatcher?: FetchDispatcher (an undici dispatcher, e.g. undici.ProxyAgent), since native fetch does not support Node.js HTTP agents. The CLI now threads its proxy-aware dispatcher through automatically, so HTTP_PROXY/HTTPS_PROXY behavior is unchanged for CLI users.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
607f0ef: Add service information to deploy-manifest.
7b30856: Add vercel dev support for Python queue subscribers defined in pyproject.toml.
vercel dev support for Python queue subscribers defined in pyproject.toml.6b49a17: Apply per-service functions config when building experimental V2 services. Previously, function configuration declared under services. .funct
functions config when building experimental V2 services. Previously, function configuration declared under services.<name>.functions in vercel.json (experimentalTriggers, maxDuration, memory, architecture, regions, functionFailoverRegions, supportsCancellation) was dropped at build time — only the top-level functions map was honored. The build now feeds each service's functions to its lambdas for both single-lambda builders (@vercel/node, etc., via writeBuildResultV3) and framework builders that read config.functions (e.g. @vercel/next, via the builder config). Derived queue/v2beta consumer groups are now scoped by the owning service name so two services that declare the same function path + topic no longer collide.8dc4702: Fix vercel dev for standalone Node servers, including projects without a package.json, and reuse the server process between requests.
vercel dev for standalone Node servers, including projects without a package.json, and reuse the server process between requests.9fb2976: Add services as the canonical multi-service project configuration and keep experimentalServicesV2 as a deprecated backwards-compatible alias.
services as the canonical multi-service project configuration and keep experimentalServicesV2 as a deprecated backwards-compatible alias.186014d: Add an experimental container service runtime. A service with
runtime: "container" either builds its Dockerfile/Containerfile and pushes
the resulting OCI image to the Vercel Container Registry (VCR), or passes a
prebuilt image reference through as build output.
@vercel/container (new builder): authenticates to VCR with the project's
VERCEL_OIDC_TOKEN, ensures the repository exists, builds and pushes the
image, and emits a digest-pinned reference in handler (container functions
are type: "Lambda" with runtime: "container"; the platform surfaces
handler as the image downstream). Uses docker on developer machines and
buildah (daemonless) in the Vercel build container behind a shared
ContainerEngine interface. Supports vc dev via startDevServer (local
build/run, env parity, log forwarding) and prepareCache for buildah layer
reuse between builds. Build flow is instrumented with tracing spans
(non-secret diagnostics) and debug logging gated on BUILDER_DEBUG.@vercel/build-utils: add the ContainerImage build-output type.@vercel/fs-detectors: resolve container services from vercel.json
(the services config and its deprecated experimentalServices /
experimentalServicesV2 aliases). A Dockerfile, Containerfile, or
*.dockerfile entrypoint triggers a build; any other entrypoint is treated as
a prebuilt OCI image reference.vercel: wire container output into vercel build result writing and
config validation.Buildah specifics in the build container: host networking for RUN steps,
native overlay storage on the XFS /vercel volume (deferring to the image's
storage.conf), zstd push compression, and registry credentials read from the
provisioned auth file when present. Several knobs are available for debugging:
VERCEL_CONTAINER_ENGINE, VERCEL_VCR_STRICT_STORAGE,
VERCEL_VCR_DISABLE_LAYER_CACHE, and VERCEL_VCR_FORCE_LOGIN.
cb0988f: Set the Node.js 20 discontinuation date to October 1, 2026.
2158ab6: [vc dev] Add support to experimentalServicesV2 for bindings in vc dev
experimentalServicesV2 for bindings in vc dev8dec9ea: Add deploy-manifest as an extension of project manifest.
01e18e8: Add hasFallback, htmlSize, and isDynamicRoute to Prerender
01e18e8: Add hasFallback, htmlSize, and isDynamicRoute to Prerender
These optional fields surface per-route PPR shell metadata in the Build Output so consumers can classify prerenders (e.g. full shell vs. empty shell vs. concrete prerender):
hasFallback — whether a dynamic route template had a static fallback (undefined for concrete prerenders)htmlSize — byte size of the prerendered .html shell (0 for an empty shell, undefined when there's no .html)isDynamicRoute — whether the entry came from a dynamic route template rather than a concrete prerender32a730e: Elevate maximum maxDuration to 1800s
…(the existing functionsSchema const is kept but deprecated). The CLI builds and compiles its config validator lazily, caching one validator per resolv…
8d8e871: Evaluate the maxDuration upper bound at validation time so VERCEL_CLI_SKIP_MAX_DURATION_LIMIT works regardless of import order.
The gate was read when @vercel/build-utils' functionsSchema was constructed and when the CLI compiled its vercel.json validator — both at module load. Any process that imports these modules before setting the env var baked in the default 900-second maximum and ignored the flag, failing with Invalid vercel.json - functions[...].maxDuration should be <= 900.
@vercel/build-utils now exposes getFunctionsSchema(), which reads the limit at call time (the existing functionsSchema const is kept but deprecated). The CLI builds and compiles its config validator lazily, caching one validator per resolved limit, so setting the variable after import takes effect. Default behavior is unchanged — the 900s maximum, the lower bound, and the integer check are all still enforced when the variable is unset.
4e849dd: Add a per-route hasPostponed signal to Prerender.
4e849dd: Add a per-route hasPostponed signal to Prerender.
@vercel/build-utils exposes a new optional hasPostponed?: boolean field on Prerender / PrerenderOptions. It is a tri-state: true when the route's .meta postponed state is present (React suspended during the build-time prerender), false when the framework prerendered a Prerender route without postponing, and undefined when the framework did not provide the signal.
@vercel/next populates it for app-router PPR routes (computed from the route's postponed state) and leaves it undefined for pages-router and other non-app-router prerenders. This is an additive, finer-grained signal — it does not change the existing chain / experimentalStreamingLambdaPath behavior — so downstream consumers can distinguish a route that actually postponed from one that has PPR machinery but fully prerendered (e.g. under cacheComponents: true).
c5eeb30: Gate the client-side 900-second maxDuration upper bound behind the VERCEL_CLI_SKIP_MAX_DURATION_LIMIT environment variable. The limit is now
maxDuration upper bound behind the VERCEL_CLI_SKIP_MAX_DURATION_LIMIT environment variable. The limit is now owned by a single helper in @vercel/build-utils instead of being hardcoded in multiple validators. When the variable is set to 1, the client-side maximum is skipped and validation defers to the server. Default behavior is unchanged — the maximum, the lower bound, and the integer check are all still enforced when the variable is unset./*, //, */) inside string, template, or regex literals — for example an Accept: */* header. Handler exports are now identified with the ES/CJS module lexers instead of stripping comments with regexes, so the contents of literals are never mistaken for comments.0a170fd: [services] wire experimentalServicesV2 into fs-detectors.
experimentalServicesV2 into fs-detectors.338cc35: Add isPackageInstalled util for detecting dependencies during build. Fix Vercel Flags dependency detection for emitting datafiles during buil
3019788: [services] Remove the services field from vercel.json and the VERCEL_USE_SERVICES gate.
services field from vercel.json and the VERCEL_USE_SERVICES gate.experimentalServicesV2 field to vercel.json implementing the new schema for services.1180675: Revert "[flags] fix dep detection for build embedding (#16242)"
6495585: [services] drop top-level env support for the new service-ref shape for services.
env support for the new service-ref shape for services.b66bd3e: Fix prebuilt deployments failing with "invalid relative path" when using the --standalone flag in pnpm monorepos by skipping external node_mo
--standalone flag in pnpm monorepos by skipping external node_modules symlinks and copying traced files at their logical paths instead.647c1e8: Cleanup getLambdaSupportsStreaming
fa25cb7: Fix config.framework in deserializeBuildOutput
fa25cb7: Fix config.framework in deserializeBuildOutput
972cc84: Support workflow-triggered job services in queue infrastructure
Add isWorkflowTriggeredService() and isQueueBackedService() helpers so workflow services
are recognized by the queue broker, dev server, and build pipeline. Update Python runtime to
bootstrap workflow services as queue-backed workers.
137e5d1: Allow builder V2 to expose startDevServer.
fb0cb8d: Add normalized entrypoint detector for runtime builders.
d874af6: Add support for env vars injection that reference other services in services with an explicit env configuration.
services with an explicit env configuration.22f77b9: Add project manifest to node builder.
services schema supportf0d7d32: Disable response streaming for lambdas with awsLambdaHandler set inside getLambdaSupportsStreaming. This closes a gap where non-Node builders
awsLambdaHandler set inside getLambdaSupportsStreaming. This closes a gap where non-Node builders (e.g. @vercel/redwood) constructed NodejsLambda with awsLambdaHandler but no explicit supportsResponseStreaming, causing finalizeLambda to silently flip streaming on for AWS custom handlers. With the gate now enforced centrally in finalizeLambda, the equivalent @vercel/node build-time check from #16266 is consolidated away — all builders go through the same gate.e53dd86: Add service type to project manifest.
c56f851: Upgrade to TypeScript 5.9
Add framework to package manifest for python and backends builders.
[build-utils] simplify streaming lambda check
[services] move Python workers to v2beta triggers with private routing
Generate PROJECTMANIFEST in @vercel/backends for Node deployments.
Align deserialize logic with existing callers.
Support dynamically specifying crons from a python service
Add shared deserialization and build-result collection utilities.
[services] allow multiple v2beta triggers for a single Lambda when config is coming from services
Add mount support for experimental services across config validation and service resolution.
mount support for experimental services across config validation and service resolution. (#15882)Restore finalizeLambda() to return zipPath: null for the default in-memory path, preserving the existing caller-facing result contract while keeping c
Support configuration via vercel.toml
Extend finalizeLambda with pluggable ZIP strategy (createZip), pre-digest validation hook (validateZip), and optional trace tags. Widen getLambdaEnvir
finalizeLambda with pluggable ZIP strategy (createZip), pre-digest validation hook (validateZip), and optional trace tags. Widen getLambdaEnvironment buffer param to { byteLength: number }. (#15856)Extract finalize/validate function utils for build-utils
Switch to using smol-toml for toml parsing
Add hash utilities (streamToDigestAsync, sha256, md5) and build result helpers (getBuildResultMetadata, getLambdaByOutputPath, isRouteMiddleware, getP
streamToDigestAsync, sha256, md5) and build result helpers (getBuildResultMetadata, getLambdaByOutputPath, isRouteMiddleware, getPrerenderChain, streamWithExtendedPayload) for shared use. (#15726)Add process-serverless utilities: getLambdaEnvironment, getLambdaPreloadScripts, getLambdaSupportsStreaming, and getEncryptedEnv.
process-serverless utilities: getLambdaEnvironment, getLambdaPreloadScripts, getLambdaSupportsStreaming, and getEncryptedEnv. (#15712)[services] support multiple topics for a single worker service
[services] support multiple topics for a single worker service (#15615)
[services] support for specifying an env prefix for each service (#15641)
Simplify python runtime by always passing in app variable (#15635)
Namespace diagnostics keys by builder and service workspace, and aggregate per-builder package-manifest.json files into a single project-manifest.json (#15399)
Updated dependencies [ac87d5a5ef5d79b55765e094efc957de987d7ac4, 25a6a2daa46baba6e8d7dec90eb49213b8150b8c]:
[services] allow services to share builder source
[services] allow services to share builder source (#15631)
Updated dependencies [8e8110d2eca5832e109f5efb64b192690100927d]:
Updated dependencies [`3c4355fa1414aa3270ba4d36423aa647d49a9cf3`, `267223f86eb578cc740db501fb2c2cbf43a27b37`, `e9a791d0fa04ef58695535fa508554415137fb5
3c4355fa1414aa3270ba4d36423aa647d49a9cf3, 267223f86eb578cc740db501fb2c2cbf43a27b37, e9a791d0fa04ef58695535fa508554415137fb58, 12811e7bc827900d534aa25f5f3e2331a80ca6a8]:
Support maxDuration: 'max' to allow the backend to resolve the maximum duration based on account plan type
[python] add support for module-based entrypoints for cron jobs
[python] add support for module-based entrypoints for cron jobs (#15393)
For the django frontend, dynamically load settings.py instead of parsing it (#15367)
83e804013528fc54de31082960ae31f58339bd71, 921314f958c4ec85adb09e020310a5becb7f866c]:
Updated dependencies [`d1c4d7052033aaf7b3f2044aa24484cb143b9348`]:
d1c4d7052033aaf7b3f2044aa24484cb143b9348]:
add partialFallback flag to prerender output
Updated dependencies [`3880e1028840aae6883211b79a1a30c7432580f3`]:
3880e1028840aae6883211b79a1a30c7432580f3]:
Find entrypoints for django projects.
Rename fetch to nodeFetch in cases where it is an import from node-fetch (#15234)
[@vercel/build-utils] fix uncaught exception in streamToBuffer when stream exceeds max Buffer size (#15276)
Remove source and destination typo suggestions for routes schema (#15014)
Support function overrides in backends builder (#15214)
Updated dependencies [b3a96cc4f276ce8d16c695eabd499d3a17e73aa8]:
Add django experimental framework.
cb79f6f8080fddd3673a8911566085e0265b060b]:
consolidate workspace and entrypoint from experimentalServices vercel.json schema
workspace and entrypoint from experimentalServices vercel.json schemaframework config in service optional -- infer framework from service workspace when not explicitly providedfc56fb91b4dafabe0f68f86efeabbaf98b2642bc]:
Updated dependencies [`88353afe588b95709af20ba2b82ba83d8a60f90c`]:
88353afe588b95709af20ba2b82ba83d8a60f90c]:
Add support for functions[*].functionFailoverRegions in vercel.json and build output config generation.
Add support for functions[*].functionFailoverRegions in vercel.json and build output config generation. (#14969)
This enables per-function failover region configuration instead of only top-level defaults for all functions.
[services] synchronize dependencies in dev mode for JS/TS and Python services
[services] synchronize dependencies in dev mode for JS/TS and Python services (#14987)
[services] inject service URLs into web services as local paths (#15024)
Add new expirementalTrigger format for queues v2beta (#14970)
Updated dependencies [a960cf23a42ff1a570c808ee9567670c24422f98]:
Nothing published for this version
One column per quarter.