# What changed in qdrant-client

> 73 changes in qdrant-client 1 from its official release notes, upgrade guides and advisories: 8 breaking, 8 deprecations, 3 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/pypi/qdrant-client/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## qdrant-client 1

### Breaking changes

- Formula variables reject negative score indices. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- The MMR offset is applied to reranked output rather than candidates. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- An unmapped StartFrom now raises instead of returning None. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local mode no longer accepts empty vectors or multivectors. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- The add method has been removed; use FastEmbed with upsert instead. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- Adds payload storage configuration to create_collection, superseding on_disk_payload. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- The query method has been removed; use FastEmbed with query_points instead. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- In local mode, values_count bounds must be satisfied by a single value. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)

### Deprecations

- max_resident_memory_percent has been deprecated. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- on_disk_payload has been deprecated in favor of the new payload config. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- recommend has been deprecated in favor of query_points. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- recommend_batch has been deprecated in favor of query_batch_points. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- recommend_groups has been deprecated in favor of query_points_groups. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- search has been deprecated in favor of query_points. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- search_batch has been deprecated in favor of query_batch_points. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- search_groups has been deprecated in favor of query_points_groups. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)

### New APIs and options

- Requests can use custom headers for tracing. (1.18.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.18.0)
- Named vectors can be created or deleted after creating a collection. (1.18.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.18.0)
- Turboquantization is introduced. (1.18.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.18.0)

### Behavior and default changes

- Local mode supports FieldCondition.is_empty. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local mode supports FieldCondition.is_null. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local mode accepts a bare point ID as a prefetch query. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local fusion applies root filters afterward and pushes them into prefetch search. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local mode mirrors the server's token-aware text and phrase matching. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- In local mode, the client warns that search_params is ignored instead of silently dropping it. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- The server version check runs in a thread to avoid blocking the async client. (1.18.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.18.0)

### Fixes and other changes

- Fixes timeout handling in the async client. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Collection existence checks reject empty collection names. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- An absent CollectionInfo.points_count remains None over gRPC. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- cosine_similarity no longer mutates the query in place. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- The datetime parse fallback completes only an hour-only UTC offset. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- delete_payload now honors nested JSON-path keys. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Fixes sorting mixed-type point IDs in the distance matrix. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Facet boolean and integer values remain distinct. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Geo filters ignore nonnumeric coordinates and reject nonfinite coordinates. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Boolean group-by keys are skipped to match server GroupId semantics. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local mode updates IDF statistics on deletion and rejects writes to absent points. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Fixes is_integer usage in the local mode formula API. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local mode makes IsNull array-aware to match server behavior. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local query parameters are validated. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local mode uses token-aware matching for MatchAny, matching server behavior. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Rejects min_should min_count values that the server rejects. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- MMR tie-breaking now matches core behavior. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Fixes the missing multivector placeholder in local mode. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Fixes local mode matching the wrong points for null and empty-should filters. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Fixes naive datetime handling and exact datetime precision in order_by. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Boolean payload values are skipped during order_by to match server semantics. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Formula PowExpression rejects zero raised to a negative exponent. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Pins keyword index prefix=False round-trip behavior over gRPC. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Fixes score-orientation handling for these query types in local mode. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- score_threshold is applied strictly according to server semantics. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Fixes shard key selector usage in update payload methods. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Fixes local single-prefetch behavior. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local mode isolates sparse vectors at storage boundaries. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Sparse vectors and vector dimensions are validated with raises instead of asserts. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Fixes start_from handling when passed a date object. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- An absent UpdateResult.operation_id remains None over gRPC. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local mode isolates payload values across wildcard targets. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local mode honors string and non-list Sequence selectors for with_payload and with_vectors. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Local mode honors string and non-list Sequence selectors for with_payload and with_vectors. (1.19.1) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.1)
- Fixes a TypeError when MatchText is applied to a non-string field. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- Prevents falsy shard keys from being dropped during conversion. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- Fixes embed paths. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- Adds limit > 0 rules in local mode. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- Fixes filters cross-matching booleans and integers in local mode. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- Fixes nested payload handling in local mode. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- REST/gRPC conversion preserves proto3 field presence for falsy values. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- Fixes local mode set_payload behavior on shared nested objects. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- Fixes update vectors in local mode. (1.19.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.19.0)
- Local mode no longer modifies date filters. (1.18.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.18.0)
- Local mode edge cases for geo filters are fixed. (1.18.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.18.0)
- A type hint error is fixed for grpc_uploader with older protobuf versions. (1.18.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.18.0)
- Local mode values counts are fixed for iterables other than lists to match the server. (1.18.0) — [release notes](https://github.com/qdrant/qdrant-client/releases/tag/v1.18.0)