The register-changelog command connects your local Liquibase activity to a specific Liquibase Hub Project. By registering your changelog, this activity will be visible only to one Project within one Organization in Liquibase Hub.


Use the register-changelog command to connect an XML, SQL, JSON, or YAML changelog to your Liquibase Hub Project.

Note: JSON and YAML changelog formats are available in Liquibase 4.2.1 and later versions.

The command assigns the changeLogId to the changelog file that you register. The changeLogId is a unique identifier in your changelog, which is automatically added by the register-changelog command to provide real-time monitoring and reports.

You can connect the needed changelog file with your existing project or create a new project.

Note: If you follow a master changelog structure, register only the master changelog without registering the nested changelogs. For more information about the structure, see Best Practices.

Running the register-changelog command

To run the register-changelog command, specify the following parameters in the Liquibase properties file, environment variables, or the command prompt while running the command:

Tip: For more information about the options to store parameters, see Specifying Properties in a Connection Profile, Liquibase Environment Variables, and JAVA_OPTS Environment Variable. To find the format of the parameter, see Command Parameters.

Run the register-changelog command:

liquibase register-changelog --changelog-file=exampleChangelog.sql

Note: Replace exampleChangelog.sql above with your changelog file title before running the command.

Non-interactive register-changelog

To run the register-changelog in the non-interactive mode, specify the --hubProjectId, which is located in Projects > View Details for the required project > Operations or any other tab of the project.

If you specify both changelog and hubProjectId, the command will register the changelog to the specified project without showing the interactive prompt:

liquibase --changelog-file=mychangelog.xml register-changelog --hubProjectId=myProjectId

The Maven register-changelog goal also runs in the non-interactive mode. For more information, see Maven register-changelog .

Tip: Process and synchronize your source and target resources to ensure you use your newly registered changelog to report operations to Liquibase Hub.