database-changelog-table-name

Last updated: January 21, 2026

--database-changelog-table-name is a global parameter that specifies the name of the DATABASECHANGELOG table. The default value is DATABASECHANGELOG.

Uses

If your organization has a custom naming convention for tables, you can use --database-changelog-table-name to ensure that the DBCL adheres to it.

If you have a multi-tenant database environment, giving unique names to resources like the DBCL may reduce the risk of conflicts between tenants.

Syntax

You can set this parameter in the following ways:

Option	Syntax
Liquibase properties file (defaults file)	`liquibase.databaseChangelogTableName: <string>`
Global flow file argument	`globalArgs: { database-changelog-table-name: "<string>" }`
Global CLI parameter	`liquibase --database-changelog-table-name=<string> update --changelog-file=example-changelog.xml`
JVM system property (JAVA_OPTS environment variable)	Unix: `JAVA_OPTS=-Dliquibase.databaseChangelogTableName=<string>` Windows: `JAVA_OPTS=-D"liquibase.databaseChangelogTableName"=<string>`
Liquibase environment variable	`LIQUIBASE_DATABASE_CHANGELOG_TABLE_NAME=<string>`

For more information, see Working with Command Parameters.