reports-drift-max-detailed-objects

Last updated: June 9, 2026

Sets the maximum number of changed objects that trigger the full detailed format in the drift report. When the number of changes exceeds this threshold, Liquibase uses a memory-efficient report format that preserves summaries and object listings but skips the most memory-intensive sections. Default: 10000.

In Liquibase Secure 5.2 and later, drift report generation includes two improvements for large databases:

  • Smart report mode — If your database has more than 10,000 changed objects (by default), the report skips the most memory-intensive sections but keeps summaries and object listings. You can adjust this limit if needed.

  • Faster processing — Report generation is faster and more memory-efficient for smaller databases.

For most users, this works automatically with no configuration required.

If you are still experiencing OutOfMemoryError exceptions, lower the threshold to trigger the optimized format sooner. Add the following to your liquibase.properties file:

liquibase.reports.drift.maxDetailedObjects=5000

This tells Liquibase to use the lightweight report format when there are more than 5,000 changes (instead of waiting until 10,000).

Learn more about heap memory here: What are the memory limits on inspecting large schema?

If you need full detailed reports for large snapshots, increase the threshold. Make sure you have sufficient heap memory available:

liquibase.reports.drift.maxDetailedObjects=50000

Syntax

You can set this property in the following ways:

Option

Syntax

CLI parameter

--reports-drift-max-detailed-objects=<integer>

Liquibase properties file (defaults file)

liquibase.reports.drift.maxDetailedObjects=<integer>

Flow file global argument (example)

globalArgs: { reports-drift-max-detailed-objects: "<integer>" }

JVM system property (JAVA_OPTS environment variable)

JAVA_OPTS=-Dliquibase.reports.drift.maxDetailedObjects=<integer>

Liquibase environment variable

LIQUIBASE_REPORTS_DRIFT_MAX_DETAILED_OBJECTS=<integer>