Liquibase Hub Projects

A Liquibase Hub Project is a structured collection of the resources used by Liquibase Community or Liquibase Pro 4.1+. An Organization can contain many Projects that include a list of your Connections, changelogs with their changesets, and the Operations, which were run on the Project's database.

A Liquibase Community or Liquibase Pro app user with a valid Liquibase Hub API Key can register a changelog to a Project. Registering a changelog enables the Liquibase operations, such as update, rollback, changelogSync, and dropAll to be recorded and available for review as Operations reports in Liquibase Hub. For more information, see Liquibase Hub Operations.

All members of an Organization can create Projects, register their changelog to the Organization's Project, and send and view Operation data to these Projects. An Organization Admin can manage access to Projects in the Organization by adding or removing members from the Organization.

Note: You can create Liquibase Hub Projects from the CLI during the registerChangeLog command process.


A connection represents a database or schema where changes are made by using the Liquibase operations that are tracked by Liquibase Hubupdate, rollback, changelogSync, and dropAll.

Connections include your JDBC URL, username, and the last operation with its date, time, and the changelog that was used for the Operation. You can also see the Operations related to the connections in more detail by selecting the specific connection.

Database schema changes to a specific connection are stored in the local DATABASECHANGELOG tracking table that exists in that connection, which is synchronized with its Liquibase Hub counterpart when working with a registered changelog. You cannot transfer Connections' data between Projects or Organizations as it is automatically captured when you report commands to Liquibase Hub.

A Project can have multiple connections. However, two Organizations and Projects should not share the same local DATABASECHANGELOG table as this is the core element tracked by local Liquibase usage, which is synchronized and reported on at Liquibase Hub. Therefore, it is a best practice to register the changelogs to the same Project if your workflow shares the same DATABASECHANGELOG table.


Liquibase Hub relies on a unique identifier in your changelog, called changeLogId, to synchronize the local deployments to your Liquibase Hub Projects. Run the registerChangeLog command using Liquibase Community or Liquibase Pro 4.1+ to connect an XML or formatted SQL changelog to an existing or new Liquibase Hub Project. (Additional changelog formats coming soon!)

Note: If you use nested changelogs, register only the master changelog without registering its nested changelogs. For more information about nested changelogs, see Liquibase Best Practices.

Once you have run the registerChangeLog command, it is a best practice to commit the changelog to source control and notify others who use this changelog to pull in changes, so that the same changelog cannot be registered with Liquibase Hub multiple times.

Next up:

Liquibase Hub Operations