March 23, 2025
+ 12
Couchbase Lite 3.0 introduces some breaking changes.
If you’re upgrading from 2.x, refer to the appropriate upgrade page — see: Upgrading Users should be able to upgrade to 3.1.x from 3.0.x without manual intervention.

Release 3.2.2 (March 2025)

Deprecation Notice

From Couchbase Lite version 3.2.2, the current Logging API is deprecated and will be removed in a future release.

Use of the deprecated and new Logging API at the same time is not supported.

See the following links for information about migrating to the new Logging API:

New Features

New Logging API

Couchbase Lite 3.2.2 introduces a new Logging API. The new Logging API has the following benefits:

  • Log sinks are now thread safe, removing risk of inconsistent states during initialization.

  • Simplified API and reduced implementation complexity.

For more information about migrating to the new Logging API, see:

Partial Index

Couchbase Lite 3.2.2 introduces support for Partial Index - Partial Value and Partial Full-Text Indexes. The Partial Index can create a smaller index, potentially improving index and query performance. You can use Partial Index to specify a WHERE clause in your index configuration. If a where clause is specified, the database will index a document only when the where clause condition is met.

For more information about Partial Index, see:

Release 3.2.1 (November 2024)

New Features

Array UNNEST and the Array Index

You can use UNNEST in queries to unpack arrays within a document into individual rows. This capability makes it possible to join them with their parent object in the query.

You can use UNNEST within the FROM clause. You can chain UNNEST to perform multi-level UNNEST.

You can also use a new type of index, the Array Index, to allow querying with UNNEST more efficiently.

For more information about Array UNNEST, see:

For more information about Array indexes, see:

Release 3.2.0 (August 2024)

Databases upgraded from 3.1.x to 3.2.x cannot be downgraded.

New Features

Vector Search is available only for 64-bit architectures and Intel processors that support the Advanced Vector Extensions 2 (AVX2) instruction set. To verify whether your device supports the AVX2 instructions set, follow these instructions.

Vector Search is now available on Couchbase Lite for all platforms. Vector Search is a sophisticated data retrieval technique that focuses on matching the contextual meanings of search queries and data entries, rather than simple text matching. Vectors are represented by arrays of numbers known as embeddings, which are generated by Large Language Models (LLMs) to represent objects such as text, images, and audio. You can use Vector Search to efficiently find similar items or content based on the similarity of their vector representations. This is useful for reducing the cost per query, performing semantic or similarity search, providing recommendations among others.

Read more at:

Extended Date/Time Functionality

Six new DateTime functions have been added to Couchbase Lite N1QL:

  • STR_TO_TZ()

  • MILLIS_TO_TZ()

  • DATE_DIFF_STR()

  • DATE_DIFF_MILLIS()

  • DATE_ADD_STR()

  • DATE_ADD_MILLIS()

Read more at:

See also

Couchbase Lite Release Notes

Vector Search Release Notes

Upgrading