objectbox

• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 5.3.2-2026-05-05
• Update ObjectBox database for Flutter Android apps to 5.3.2-2026-05-05.
  If your project is using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:5.4.2 in android/app/build.gradle.kts or android/app/build.gradle.
• Update ObjectBox database for Flutter iOS/macOS apps to 5.3.2-next-2026-05-16.
  For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 5.3.2-2026-05-05
• Update ObjectBox database for Flutter Android apps to 5.3.2-2026-05-05.
  If your project is using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:5.4.2 in android/app/build.gradle.kts or android/app/build.gradle.
• Update ObjectBox database for Flutter iOS/macOS apps to 5.3.2-next-2026-05-16. For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 5.3.1-2026-03-26
• Update ObjectBox database for Flutter Android apps to 5.3.1-2026-03-26.
  If your project is using Admin, make
  sure to update to io.objectbox:objectbox-android-objectbrowser:5.4.1 in
  android/app/build.gradle.kts or android/app/build.gradle.
• Update ObjectBox database for Flutter iOS/macOS apps to 5.3.1-2026-03-26.
  For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

Sync

• Critical fix for Sync clocks
• Add Sync.syncClockTimestamp() to get a timestamp from a Sync clock (and a variation for a corrected timestamp)

• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 5.3.1-2026-03-26
• Update ObjectBox database for Flutter Android apps to 5.3.1-2026-03-26. If your project is using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:5.4.1 in android/app/build.gradle.kts or android/app/build.gradle.
• Update ObjectBox database for Flutter iOS/macOS apps to 5.3.1-2026-03-26. For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

Sync

• Critical fix for Sync clocks
• Add Sync.syncClockTimestamp() to get a timestamp from a Sync clock (and a variation for a corrected timestamp)

For Sync clocks, please update to 5.3.1

• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 5.3.0-2026-03-23
• Update ObjectBox database for Flutter Android apps to 5.3.0-2026-03-23.
  If your project is using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:5.4.0 in
  android/app/build.gradle.kts or android/app/build.gradle.
• Update ObjectBox database for Flutter iOS/macOS apps to 5.3.0-2026-03-23.
  For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

Sync

• Customizable conflict resolution via the new annotations @SyncClock() and @SyncPrecedence() (see docs for details)
• Sync protocol version 10
• SyncClient: support updating filter variables. After login, stage updates using put and remove, then schedule to send them to the server with applyFilterVariables().
• Clients report errors to the server
• Fix bad Sync client state after multiple full sync messages were interrupted
• Fix adding indexes to Sync types

Warning: Do not use this version for sync clocks, it contains a severe bug! Use 5.3.1 instead.

• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 5.3.0-2026-03-23
• Update ObjectBox database for Flutter Android apps to 5.3.0-2026-03-23. If your project is using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:5.4.0 in android/app/build.gradle.kts or android/app/build.gradle.
• Update ObjectBox database for Flutter iOS/macOS apps to 5.3.0-2026-03-23. For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

Sync

• Sync protocol version 10
• Conflict resolution via the new annotations @SyncClock() and @SyncPrecedence() (allows last win with custom conflict resolution)
• SyncClient: support updating filter variables. After login, stage updates using put and remove, then schedule to send them to the server with applyFilterVariables().
• Clients report errors to the server
• Fix bad Sync client state after multiple full sync messages were interrupted
• Fix adding indexes to Sync types

Prepare release 5.3.0-preview2

Update Android version to 5.2.1-preview1

• Allow analyzer versions 9 and 10. #780
• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 5.1.0-2026-01-19.
• Update ObjectBox database for Flutter Android apps to 5.1.0-2026-01-19.
  If your project is using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:5.1.0 in android/app/build.gradle.kts or android/app/build.gradle.
• Update ObjectBox database for Flutter iOS/macOS apps to 5.1.1-dev-2026-01-21.
  For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

Sync

• New Sync protocol V8: using new clients also requires a server update
• SyncClient: add a constructor, deprecate Sync.client and related helper methods.
• SyncClient: add constructor parameters to provide custom certificates and configuration flags.
  • Remove-operations with object content for Sync filters (optional setting; sync flag)
  • Add DebugLogTxLogs sync flag to log TX log processing on the client side
  • Add SkipInvalidTxOps sync flag to skip invalid operations in a TX log on the client side; errors
    are logged and the TX is only partially applied.
• Remove superfluous sync listener triggers when sync filters "report updates" (SKIP_TX)
• Sync clients compress earlier: reduces disk storage for outgoing data
• Reworked certificates for Apple platforms
• Removed support for older Sync protocol versions before 2024-09; protocol V5+ is now required.

• Allow analyzer versions 9 and 10. #780
• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 5.1.0-2026-01-19.
• Update ObjectBox database for Flutter Android apps to 5.1.0-2026-01-19. If your project is using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:5.1.0 in android/app/build.gradle.kts or android/app/build.gradle.
• Update ObjectBox database for Flutter iOS/macOS apps to 5.1.1-dev-2026-01-21. For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

Sync

• New Sync protocol V8: using new clients also requires a server update
• SyncClient: add a constructor, deprecate Sync.client and related helper methods.
• SyncClient: add constructor parameters to provide custom certificates and configuration flags.
  • Remove-operations with object content for Sync filters (optional setting; sync flag)
  • Add DebugLogTxLogs sync flag to log TX log processing on the client side
  • Add SkipInvalidTxOps sync flag to skip invalid operations in a TX log on the client side; errors are logged and the TX is only partially applied.
• Remove superfluous sync listener triggers when sync filters "report updates" (SKIP_TX)
• Sync clients compress earlier: reduces disk storage for outgoing data
• Reworked certificates for Apple platforms
• Removed support for older Sync protocol versions before 2024-09; protocol V5+ is now required.

• Added flex properties that can hold any kind of data ("schema-less") supporting the following types on the Dart side:
  • Maps: JSON-like data structure with string keys and arbitrary values, including nested maps and lists.
  • Lists: can hold elements of any type, even mixed (like JSON arrays).
    On the Dart side, ObjectBox also offers binding to a list of maps, e.g. List<Map<String, dynamic>>.
  • Dynamic/Object: can hold any kind of data, including primitive types like integer, floating point and string,
    plus maps and lists.
  • Sync note: when used together with the MongoDB Connector,
    flex properties allow storing nested documents from MongoDB.
• Added dateUtc and dateUtcNano property types for DateTime read back UTC.
  #308
• Added "GeneratorVersion" enum to enforce generated code is compatible with the runtime library.
  You must run dart run build_runner build after updating the objectbox package.
  Until you regenerate code, compiling will fail with a message like this:
  "Error: Required named parameter 'generatorVersion' must be provided".

• Added flex properties that can hold any kind of data ("schema-less") supporting the following types on the Dart side:
  • Maps: JSON-like data structure with string keys and arbitrary values, including nested maps and lists.
  • Lists: can hold elements of any type, even mixed (like JSON arrays). On the Dart side, ObjectBox also offers binding to a list of maps, e.g. List<Map<String, dynamic>>.
  • Dynamic/Object: can hold any kind of data, including primitive types like integer, floating point and string, plus maps and lists.
  • Sync note: when used together with the MongoDB Connector, flex properties allow storing nested documents from MongoDB
• Added dateUtc and dateUtcNano property types for DateTime read back UTC. #308
• Added "GeneratorVersion" enum to enforce generated code is compatible with the runtime library. You must run dart run build_runner build after updating the objectbox package. Until you regenerate code, compiling will fail with a message like this: "Error: Required named parameter 'generatorVersion' must be provided".

• Update ObjectBox database for Flutter iOS/macOS apps to 5.1.1.
  For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.
  • Sync client: fix for encrypted (wss://) connections on iOS devices.

• Update ObjectBox database for Flutter iOS/macOS apps to 5.1.1. For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.
  • Sync client: fix for encrypted (wss://) connections on iOS devices.

• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 5.0.0.
• Update ObjectBox database for Flutter iOS/macOS apps to 5.1.0.
  Requires macOS 11 or iOS 15 and at least Swift 6.1 tools to compile.
  For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 5.0.0.
• Update ObjectBox database for Flutter iOS/macOS apps to 5.1.0. Requires macOS 11 or iOS 15 and at least Swift 6.1 tools to compile. For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

• macOS: throw an error if the macosApplicationGroup parameter when opening a Store is too long (or empty). #515

Sync

• SyncClient: actually configure Sync filters when passing them to Sync.client and related helper methods.

• macOS: throw an error if the macosApplicationGroup parameter when opening a Store is too long (or empty). #515

Sync

• SyncClient: actually configure Sync filters when passing them to Sync.client and related helper methods.

• Generator: migrate to analyzer 8 APIs. Require at least analyzer 8.1.1 and source_gen 4.0.1. Resolves Error: The method 'getInvocation' isn't defined when running the generator using analyzer 8.4.0 (it removes APIs that older source_gen versions were using).

• Generator: require at least build 4.0.0. This will also allow using build_runner versions 2.7.2 or newer. #759

• For ToOne support renaming the implicitly created target ID (or "relation") property:

  // Change target ID property name from default "customerId" to "customerRef"
  @TargetIdProperty('customerRef')
  final customer = ToOne<Customer>();
  

  This can be useful if the default name needs to be used for another property. Or when syncing with MongoDB to match the name used in the MongoDB database. #713

• Provide a helpful error message if the name of a property conflicts with a target ID property created for a ToOne relation. #713

• Generator: find @Backlink() source relation also in case target entity class is processed first. #687

Sync

• SyncClient: support triggerReconnect().

To upgrade to this major release run flutter pub upgrade objectbox --major-versions (or for Dart Native apps dart pub upgrade objectbox --major-versions).

Sync

• Support Sync server version 5.0.
  • User-Specific Data Sync: support configuring Sync filter variables on SyncClient.

Other Changes

• Flutter packages are compiled with Android SDK 35 to support Android Gradle Plugin 8.13 #755. They are also built using a language level of Java 11.
• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 5.0.0-rc.
  • ToOne relations: when deleting an object with an ID larger than the maximum 32-bit unsigned integer (4_294_967_295) that is used as the target object of a ToOne, correctly re-set the target ID of the ToOne to 0. #740
• Update ObjectBox database for Flutter Android apps to 5.0.1. If your project is using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:5.0.1 in android/app/build.gradle.
• Update ObjectBox database for Flutter iOS/macOS apps to 5.0.0. For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.
• Remove deprecated contains condition for List<String> properties, use containsElement instead.

• Requires at least Dart SDK 3.7 or Flutter SDK 3.29.
• Migrate generator to analyzer 7.4 and source_gen 3.1 APIs. Allow analyzer version 8. #742
• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 4.3.1.
• Update ObjectBox database for Flutter Android apps to 4.3.1. If your project is using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:4.3.1 in android/app/build.gradle.
  • Admin for Android: do not display values twice. #738
• Update ObjectBox database for Flutter iOS/macOS apps to 4.3.1. For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 4.3.0. This includes significant improvements to ObjectBox Sync like raising the maximum messages/transaction size.
• Update ObjectBox database for Flutter Android apps to 4.3.0. If your project is using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:4.3.0 in android/app/build.gradle.
• Update ObjectBox database for Flutter iOS/macOS apps to 4.3.0. For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.
• External property types (via MongoDB connector): add jsonToNative to support sub (embedded/nested) documents/arrays in MongoDB.

• Requires at least Dart SDK 3.4 or Flutter SDK 3.22.
• Allow analyzer 7, dart_style 3, source_gen 2 and pointycastle 4. #705
• Examples: demos are compatible with JDK 21 included with Android Studio Ladybug or later, require Flutter SDK 3.24 (with Dart SDK 3.5) or newer.
• Update ObjectBox database for Flutter Linux/Windows, Dart Native apps to 4.2.0.
• Update ObjectBox database for Flutter Android apps to 4.2.0. If your project is using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:4.2.0 in android/app/build.gradle.
• Update ObjectBox database for Flutter iOS/macOS apps to 4.2.0. For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

• Flutter for Android: requires Android 5.0 (API level 21).
• Vector Search: You can now use the new VectorDistanceType.GEO distance-type to perform vector searches on geographical coordinates. This is particularly useful for location-based applications.
• Flutter for Linux/Windows, Dart Native: update to objectbox-c 4.1.0.
• Flutter for Android: update to objectbox-android 4.1.0. If your project is using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:4.1.0 in android/app/build.gradle.
• Flutter for iOS/macOS: update to objectbox-swift 4.1.0. For existing projects, run pod repo update and pod update ObjectBox in the ios or macos directories.

Sync

• Add JWT authentication.
• Sync clients can send multiple credentials for login.

• Generator: replace cryptography library, allows to use newer versions of the transitive js dependency. #638
• iOS: support Query.findWithScores() with big objects (> 4 KB), previously would throw a StorageException: Do not use vector-based find on 32 bit systems with big objects. #676
• Make closing the Store more robust. It waits for ongoing queries and transactions to finish. This is just an additional safety net. Your code should still make sure to finish all Store operations, like queries, before closing it.
• Flutter for Linux/Windows, Dart Native: update to objectbox-c 4.0.2.
• Flutter for iOS/macOS: update to objectbox-swift 4.0.1. Existing projects may have to run pod repo update and pod update ObjectBox.
• Flutter for Android: update to objectbox-android 4.0.3. If you are using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:4.0.3 in android/app/build.gradle.

Sync

• Fix a serious regression, please update as soon as possible.
• Add special compression for tiny transactions (internally).

• Sync: support option to enable shared global IDs.

• Export ObjectWithScore and IdWithScore used by the new find with score Query methods. #637
• Add simple vectorsearch_cities Dart Native example application.

Note: this release includes the same versions of the Android library and ObjectBox pod as release 4.0.0. See update instructions there.

To upgrade to this major release run flutter pub upgrade objectbox --major-versions (or for Dart Native apps dart pub upgrade objectbox --major-versions).

ObjectBox now supports on-device Vector Search to enable efficient similarity searches.

This is particularly useful for AI/ML/RAG applications, e.g. image, audio, or text similarity. Other use cases include semantic search or recommendation engines.

Create a Vector (HNSW) index for a floating point vector property. For example, a City with a location vector:

@Entity()
class City {

  @HnswIndex(dimensions: 2)
  @Property(type: PropertyType.floatVector)
  List<double>? location;

}

Perform a nearest neighbor search using the new nearestNeighborsF32(queryVector, maxResultCount) query condition and the new "find with scores" query methods (the score is the distance to the query vector). For example, find the 2 closest cities:

final madrid = [40.416775, -3.703790];
final query = box
    .query(City_.location.nearestNeighborsF32(madrid, 2))
    .build();
final closest = query.findWithScores()[0].object;

For an introduction to Vector Search, more details and other supported languages see the Vector Search documentation.

• The generator correctly errors when using an unsupported index on a vector type.
• Flutter for Linux/Windows, Dart Native: update to objectbox-c 4.0.0.
• Flutter for Android: update to objectbox-android 4.0.0. If you are using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:4.0.0 in android/app/build.gradle.
• Flutter for iOS/macOS: update to objectbox-swift 2.0.0. Existing projects may have to run pod repo update and pod update ObjectBox.

• Add SyncCredentials.userAndPassword().
• Change SyncCredentials from constructors to static methods. This should not require any changes in your code.

• Support creating file-less in-memory databases, for example for caching or testing. To create one pass an in-memory identifier together with Store.inMemoryPrefix as the directory:

   final inMemoryStore =
       Store(getObjectBoxModel(), directory: "${Store.inMemoryPrefix}test-db");
  

  See the Store documentation for details.

• Add Store.removeDbFiles() to conveniently delete database files or an in-memory database.

• Add Store.dbFileSize() to get the size in bytes of the main database file or memory occupied by an in-memory database.

• Add relationCount() query condition to match objects that have a certain number of related objects pointing to them. E.g. Customer_.orders.relationCount(2) will match all customers with two orders. Customer_.orders.relationCount(0) will match all customers with no associated order. This can be useful to find objects where the relation was dissolved, e.g. after the related object was removed.

• Support for setting a maximum data size via the maxDataSizeInKB property when building a Store. This is different from the existing maxDBSizeInKB property in that it is possible to remove data after reaching the limit and continue to use the database. See the Store documentation for more details.

• For DateTime properties new convenience query conditions are generated that accept DateTime and auto-convert to milliseconds (or nanoseconds for @Property(type: PropertyType.dateNano)) #287

  // For example instead of:
  Order_.date.between(DateTime(2024, 1).millisecondsSinceEpoch, DateTime(2024, 2).millisecondsSinceEpoch)
  // You can now just write:
  Order_.date.betweenMilliseconds(DateTime(2024, 1), DateTime(2024, 2))
  

• When defining a property with a getter and setter instead of a field, support annotating the getter to configure or ignore the property #392

  For example, it is now possible to do this:

  @Property(type: PropertyType.date)
  @Index()
  DateTime get date => TODO;
  set date(DateTime value) => TODO;
  
  @Transient()
  int get computedValue => TODO;
  set computedValue(int value) => TODO;
  

• For Flutter apps: loadObjectBoxLibraryAndroidCompat() is now called by default when using openStore() (effective after re-running flutter pub run build_runner build). For devices running Android 6 or older this will pre-load the ObjectBox library in Java to prevent errors when loading it in Dart.

  If your code was calling the compat method manually, remove the call and re-run above command.

  Let us know if there are issues with this change in #369!

• Avoid conflicts with entity class names in generated code #519

• Flutter for Linux/Windows, Dart Native: update to objectbox-c 0.21.0.

• Flutter for Android: update to objectbox-android 3.8.0. If you are using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:3.8.0 in android/app/build.gradle.

• Flutter for iOS/macOS: update to objectbox-swift 1.9.2. Existing projects may have to run pod repo update and pod update ObjectBox.

• Fix crash in Flutter plugin when running in debug mode on iOS. #561
• Support Flutter projects using Android Gradle Plugin 8. #581
• Flutter for Linux/Windows: fix CMake build deprecation warning. #522
• Flutter for Linux/Windows, Dart Native: update to objectbox-c 0.20.0.
• Flutter for Android: update to objectbox-android 3.7.1. If you are using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:3.7.1 in android/app/build.gradle. Notably requires Android 4.4 (API 19) or higher.
• Flutter for iOS/macOS: update to objectbox-swift 1.9.1. Existing projects may have to run pod repo update and pod update ObjectBox. Notably requires at least iOS 12.0 and macOS 10.15.
• Sync: add Sync.clientMultiUrls to work with multiple servers.

• Fix "Loaded ObjectBox core dynamic library has unsupported version 0.18.1" on Android

• Query support for integer and floating point lists: For integer lists (excluding byte lists) greater, less and equal are supported on elements of the vector (e.g. "has element greater").

  For floating point lists greater and less queries are supported on elements of the vector (e.g. "has element greater").

  A simple example is a shape entity that stores a palette of RGB colors:

  @Entity()
  class Shape {
      @Id()
      int id = 0;
  
      // An array of RGB color values that are used by this shape.
      Int32List? palette;
  }
  
  // Find all shapes that use red in their palette
  final query = store.box<Shape>()
          .query(Shape_.palette.equals(0xFF0000))
          .build();
  query.findIds();
  query.close();
  

• Queries: all expected results are now returned when using a less-than or less-or-equal condition for a String property with IndexType.value. #318

• Queries: when combining multiple conditions with OR and adding a condition on a related entity ("link condition") the combined conditions are now properly applied. #546

• Update: objectbox-c 0.19.0. Notably now requires glibc 2.28 or higher (and GLIBCXX_3.4.25); e.g. at least Debian Buster 10 (2019) or Ubuntu 20.04.

• Update: objectbox-swift 1.9.0. Existing projects may have to run pod repo update and pod update ObjectBox.

• Update: objectbox-android 3.7.0. If you are using Admin, make sure to update to io.objectbox:objectbox-android-objectbrowser:3.7.0.

• Resolve an issue where not all query results are returned, when an entity constructor or property setter itself executes a query. #550

• For Flutter apps running on Android 6 (or older): added loadObjectBoxLibraryAndroidCompat() to objectbox_flutter_libs (and objectbox_sync_flutter_libs). Use this to fix loading the ObjectBox library on these devices.

  Let us know if this works for you in #369! We might consider calling this automatically in a future release.

• Improve code generator performance if there are many entities with many constructor parameters.

• Throw StateError instead of crashing on closed Box, Query and PropertyQuery.

• Export query property classes to make them usable in user code.

• Resolve an issue where unexpected data was returned when doing a read operation in an entity constructor or property setter. #550