The customize subcommand allows you to customize dynamic checks specified in your check configurations – --checks-settings-file.


Using the customize subcommand, you can provide your values or change the default values of checks that have customization options.

Examples include lists of data types, Change Types, strings, or regular expressions that should be reported, and others.

Liquibase does not allow you to customize static checks.

Note: To view a list of available checks, run liquibase checks show.

Running the customize command

The command is interactive, and you need to follow the CLI output messages to run it:

  1. Run the command specifying your values:
  2. liquibase checks customize --check-name=TableColumnLimit

    Note: If you have a checks settings file customized for a specific environment or project, you need to pass that using the --checks-settings-file parameter. If you do not include this parameter, Liquibase uses the default settings file: liquibase.checks-settings.conf.

  3. Enter the value you want to change.

The command updates the value of a check in the checks settings file. To run the check, use the run command.


Tip: For best results, specify all commands and parameters with the --kebab-case format in the CLI. If your preference is camelCase, it will still work in the CLI.

Name Syntax Description

CLI: --checks-settings-file

Property: liquibase.command.checks.customize.checksSettingsFile


Specifies the checks settings file to use with subcommands.

Write the relative path of the settings file that you want to read from or modify.

For more information, see Using the Checks Settings Configuration File .


CLI: --check-name

Property: liquibase.command.checks.customize.checkName


Use this to specify the short name of the check you want to target with one of the following subcommands:

  • copy
  • customize
  • delete
  • disable
  • enable
  • reset
  • run

CLI: --auto-update=[on|off]

Property: liquibase.command.checks.customize.autoUpdate: [on|off]


Allows automatic backup and updating of the liquibase.check-settings.conf file when new quality checks are available.

Default: off

Related links