npm / weaviate-client
weaviate-client
What changed in weaviate-client 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.
2 breaking1 deprecations32 new APIs and options1 behavior and defaults4 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initweaviate-client 340 changes
Breaking changes 2
Drops support for Node.js 20.
Cleans up the deprecated X-Weaviate-Api-Key header.
Deprecations 1
The chunkSize parameter is deprecated.
New APIs and options 32
Adds the AND_CROSS operator for BM25.
Hybrid search now supports MMR diversity.
Adds the multi2vec-twelvelabs module.
The text2vec-aws vectorizer now accepts optional dimensions.
The text2vec-google vectorizer now accepts an optional location parameter.
Introduces a web client.
A Boost parameter is available for all query types.
Near-queries support diversity selection.
Exposes the v1.37 tokenization configuration field through the public types.
Adds the text2vec-digitalocean vectorizer module.
Exposes the v1.37 tokenization configuration field through the public types.
Adds createFromJson for creating data from JSON.
Adds exportToJson for exporting data to JSON.
Adds the ability to cancel searches while they are in flight.
Adds support for Weaviate 1.37 features.
Async replication options can be configured when creating or updating a collection.
The client supports cancelling backup restore operations.
The client supports new backup restore statuses.
The Cohere reranker accepts a baseURL, allowing its endpoint to be configured.
The client introduces batch data ingestion.
The collection.config namespace adds dropInvertedIndex.
The client adds reconfigure options for Dynamic indexes.
The client adds configuration parameters for HFresh.
Backup status now returns the backup size.
Adds Contextual AI's Generative and Reranker Client.
Adds the multi2multivec-weaviate vectorizer.
Adds support for object TTL, allowing developers to configure object time-to-live.
Adds support for the voyage-multimodal-3.5 model, including video.
List backups now returns additional fields and supports ordering.
Adds a dimensions property to Text2VecCohereConfig.
Adds a dimensions property to Text2VecVoyageAIConfig.
Adds backup options for zstd.
Behavior and default changes 1
API requests now include a client version header.
Fixes and other changes 4
Fixes mapping of the Boost decay field to proto decayValue.
Re-exports WeaviateClass from where it is used in the public API.
The client reads RQ configuration for Flat indexes.
Fixes quantization and encoding for multimodal multi-vector vectorizers.