Reference
Version · 6.0
Change Automation Reference

releases

Last updated: September 29, 2026

Use the releases attribute to tag a changeset with the release or releases it ships in. At runtime, you can control which tagged changesets a command runs using the releases-filter argument.

Note: The releases attribute requires Liquibase Secure 5.2.2 or later.

Uses

You can specify a release name as any case-insensitive string, such as v1.0 or 2026-q3, or a comma-separated list of release names. You can typically use releases to:

Tag each changeset with the release or releases it ships in, such as v1.0 or v1.1.
Deploy only the changesets that belong to a specific release, or to a set of releases.
Roll back the changesets from one release without affecting changesets from other releases.
Limit which changesets a checks run operation inspects to the current release.

Syntax

Add the releases attribute to a changeset in any changelog format. You can specify a single value or a comma-separated list.

Note: In XML changelogs, the attribute name must be lowercase (releases). In other formats, the attribute name is case-insensitive.

--liquibase formatted sql

--changeset your.name:1-create-employees releases:v1.0,v1.1
CREATE TABLE employees (id INT NOT NULL PRIMARY KEY, name VARCHAR(100) NOT NULL, department VARCHAR(50));
--rollback DROP TABLE employees;

--changeset your.name:2-create-products releases:v1.1
CREATE TABLE products (id INT NOT NULL PRIMARY KEY, name VARCHAR(100) NOT NULL, price DECIMAL(10,2));
--rollback DROP TABLE products;

--changeset your.name:3-create-audit-log releases:v2.0
CREATE TABLE audit_log (id INT NOT NULL PRIMARY KEY, action VARCHAR(255), performed_at TIMESTAMP);
--rollback DROP TABLE audit_log;

--changeset your.name:4-create-app-config
CREATE TABLE app_config (id INT NOT NULL PRIMARY KEY, setting_name VARCHAR(100));
--rollback DROP TABLE app_config;

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog
    xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd">

    <changeSet id="1-create-employees" author="your.name" releases="v1.0,v1.1">
        <createTable tableName="employees">
            <column name="id" type="int" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="name" type="varchar(100)">
                <constraints nullable="false"/>
            </column>
            <column name="department" type="varchar(50)"/>
        </createTable>
        <rollback>
            <dropTable tableName="employees"/>
        </rollback>
    </changeSet>

    <changeSet id="2-create-products" author="your.name" releases="v1.1">
        <createTable tableName="products">
            <column name="id" type="int" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="name" type="varchar(100)">
                <constraints nullable="false"/>
            </column>
            <column name="price" type="decimal(10,2)"/>
        </createTable>
        <rollback>
            <dropTable tableName="products"/>
        </rollback>
    </changeSet>

    <changeSet id="3-create-audit-log" author="your.name" releases="v2.0">
        <createTable tableName="audit_log">
            <column name="id" type="int" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="action" type="varchar(255)"/>
            <column name="performed_at" type="timestamp"/>
        </createTable>
        <rollback>
            <dropTable tableName="audit_log"/>
        </rollback>
    </changeSet>

    <changeSet id="4-create-app-config" author="your.name">
        <createTable tableName="app_config">
            <column name="id" type="int" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="setting_name" type="varchar(100)"/>
        </createTable>
        <rollback>
            <dropTable tableName="app_config"/>
        </rollback>
    </changeSet>

</databaseChangeLog>

databaseChangeLog:
  - changeSet:
      id: 1-create-employees
      author: your.name
      releases: 'v1.0,v1.1'
      changes:
        - createTable:
            tableName: employees
            columns:
              - column:
                  name: id
                  type: int
                  autoIncrement: true
                  constraints:
                    primaryKey: true
                    nullable: false
              - column:
                  name: name
                  type: varchar(100)
              - column:
                  name: department
                  type: varchar(50)
      rollback:
        - dropTable:
            tableName: employees
  - changeSet:
      id: 2-create-products
      author: your.name
      releases: 'v1.1'
      changes:
        - createTable:
            tableName: products
            columns:
              - column:
                  name: id
                  type: int
                  autoIncrement: true
                  constraints:
                    primaryKey: true
                    nullable: false
              - column:
                  name: name
                  type: varchar(100)
              - column:
                  name: price
                  type: decimal(10,2)
      rollback:
        - dropTable:
            tableName: products
  - changeSet:
      id: 3-create-audit-log
      author: your.name
      releases: 'v2.0'
      changes:
        - createTable:
            tableName: audit_log
            columns:
              - column:
                  name: id
                  type: int
                  autoIncrement: true
                  constraints:
                    primaryKey: true
                    nullable: false
              - column:
                  name: action
                  type: varchar(255)
              - column:
                  name: performed_at
                  type: timestamp
      rollback:
        - dropTable:
            tableName: audit_log
  - changeSet:
      id: 4-create-app-config
      author: your.name
      changes:
        - createTable:
            tableName: app_config
            columns:
              - column:
                  name: id
                  type: int
                  autoIncrement: true
                  constraints:
                    primaryKey: true
                    nullable: false
              - column:
                  name: setting_name
                  type: varchar(100)
      rollback:
        - dropTable:
            tableName: app_config

{
    "databaseChangeLog": [
        {
            "changeSet": {
                "id": "1-create-employees",
                "author": "your.name",
                "releases": "v1.0,v1.1",
                "changes": [
                    {
                        "createTable": {
                            "tableName": "employees",
                            "columns": [
                                {
                                    "column": {
                                        "name": "id",
                                        "type": "int",
                                        "autoIncrement": true,
                                        "constraints": {
                                            "primaryKey": true,
                                            "nullable": false
                                        }
                                    }
                                },
                                {
                                    "column": {
                                        "name": "name",
                                        "type": "varchar(100)"
                                    }
                                },
                                {
                                    "column": {
                                        "name": "department",
                                        "type": "varchar(50)"
                                    }
                                }
                            ]
                        }
                    }
                ],
                "rollback": [
                    {
                        "dropTable": {
                            "tableName": "employees"
                        }
                    }
                ]
            }
        },
        {
            "changeSet": {
                "id": "2-create-products",
                "author": "your.name",
                "releases": "v1.1",
                "changes": [
                    {
                        "createTable": {
                            "tableName": "products",
                            "columns": [
                                {
                                    "column": {
                                        "name": "id",
                                        "type": "int",
                                        "autoIncrement": true,
                                        "constraints": {
                                            "primaryKey": true,
                                            "nullable": false
                                        }
                                    }
                                },
                                {
                                    "column": {
                                        "name": "name",
                                        "type": "varchar(100)"
                                    }
                                },
                                {
                                    "column": {
                                        "name": "price",
                                        "type": "decimal(10,2)"
                                    }
                                }
                            ]
                        }
                    }
                ],
                "rollback": [
                    {
                        "dropTable": {
                            "tableName": "products"
                        }
                    }
                ]
            }
        },
        {
            "changeSet": {
                "id": "3-create-audit-log",
                "author": "your.name",
                "releases": "v2.0",
                "changes": [
                    {
                        "createTable": {
                            "tableName": "audit_log",
                            "columns": [
                                {
                                    "column": {
                                        "name": "id",
                                        "type": "int",
                                        "autoIncrement": true,
                                        "constraints": {
                                            "primaryKey": true,
                                            "nullable": false
                                        }
                                    }
                                },
                                {
                                    "column": {
                                        "name": "action",
                                        "type": "varchar(255)"
                                    }
                                },
                                {
                                    "column": {
                                        "name": "performed_at",
                                        "type": "timestamp"
                                    }
                                }
                            ]
                        }
                    }
                ],
                "rollback": [
                    {
                        "dropTable": {
                            "tableName": "audit_log"
                        }
                    }
                ]
            }
        },
        {
            "changeSet": {
                "id": "4-create-app-config",
                "author": "your.name",
                "changes": [
                    {
                        "createTable": {
                            "tableName": "app_config",
                            "columns": [
                                {
                                    "column": {
                                        "name": "id",
                                        "type": "int",
                                        "autoIncrement": true,
                                        "constraints": {
                                            "primaryKey": true,
                                            "nullable": false
                                        }
                                    }
                                },
                                {
                                    "column": {
                                        "name": "setting_name",
                                        "type": "varchar(100)"
                                    }
                                }
                            ]
                        }
                    }
                ],
                "rollback": [
                    {
                        "dropTable": {
                            "tableName": "app_config"
                        }
                    }
                ]
            }
        }
    ]
}

--liquibase formatted sql

--changeset your.name:1-create-employees releases:v1.0,v1.1
CREATE TABLE employees (id INT NOT NULL PRIMARY KEY, name VARCHAR(100) NOT NULL, department VARCHAR(50));
--rollback DROP TABLE employees;

--changeset your.name:2-create-products releases:v1.1
CREATE TABLE products (id INT NOT NULL PRIMARY KEY, name VARCHAR(100) NOT NULL, price DECIMAL(10,2));
--rollback DROP TABLE products;

--changeset your.name:3-create-audit-log releases:v2.0
CREATE TABLE audit_log (id INT NOT NULL PRIMARY KEY, action VARCHAR(255), performed_at TIMESTAMP);
--rollback DROP TABLE audit_log;

--changeset your.name:4-create-app-config
CREATE TABLE app_config (id INT NOT NULL PRIMARY KEY, setting_name VARCHAR(100));
--rollback DROP TABLE app_config;

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog
    xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd">

    <changeSet id="1-create-employees" author="your.name" releases="v1.0,v1.1">
        <createTable tableName="employees">
            <column name="id" type="int" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="name" type="varchar(100)">
                <constraints nullable="false"/>
            </column>
            <column name="department" type="varchar(50)"/>
        </createTable>
        <rollback>
            <dropTable tableName="employees"/>
        </rollback>
    </changeSet>

    <changeSet id="2-create-products" author="your.name" releases="v1.1">
        <createTable tableName="products">
            <column name="id" type="int" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="name" type="varchar(100)">
                <constraints nullable="false"/>
            </column>
            <column name="price" type="decimal(10,2)"/>
        </createTable>
        <rollback>
            <dropTable tableName="products"/>
        </rollback>
    </changeSet>

    <changeSet id="3-create-audit-log" author="your.name" releases="v2.0">
        <createTable tableName="audit_log">
            <column name="id" type="int" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="action" type="varchar(255)"/>
            <column name="performed_at" type="timestamp"/>
        </createTable>
        <rollback>
            <dropTable tableName="audit_log"/>
        </rollback>
    </changeSet>

    <changeSet id="4-create-app-config" author="your.name">
        <createTable tableName="app_config">
            <column name="id" type="int" autoIncrement="true">
                <constraints primaryKey="true" nullable="false"/>
            </column>
            <column name="setting_name" type="varchar(100)"/>
        </createTable>
        <rollback>
            <dropTable tableName="app_config"/>
        </rollback>
    </changeSet>

</databaseChangeLog>

databaseChangeLog:
  - changeSet:
      id: 1-create-employees
      author: your.name
      releases: 'v1.0,v1.1'
      changes:
        - createTable:
            tableName: employees
            columns:
              - column:
                  name: id
                  type: int
                  autoIncrement: true
                  constraints:
                    primaryKey: true
                    nullable: false
              - column:
                  name: name
                  type: varchar(100)
              - column:
                  name: department
                  type: varchar(50)
      rollback:
        - dropTable:
            tableName: employees
  - changeSet:
      id: 2-create-products
      author: your.name
      releases: 'v1.1'
      changes:
        - createTable:
            tableName: products
            columns:
              - column:
                  name: id
                  type: int
                  autoIncrement: true
                  constraints:
                    primaryKey: true
                    nullable: false
              - column:
                  name: name
                  type: varchar(100)
              - column:
                  name: price
                  type: decimal(10,2)
      rollback:
        - dropTable:
            tableName: products
  - changeSet:
      id: 3-create-audit-log
      author: your.name
      releases: 'v2.0'
      changes:
        - createTable:
            tableName: audit_log
            columns:
              - column:
                  name: id
                  type: int
                  autoIncrement: true
                  constraints:
                    primaryKey: true
                    nullable: false
              - column:
                  name: action
                  type: varchar(255)
              - column:
                  name: performed_at
                  type: timestamp
      rollback:
        - dropTable:
            tableName: audit_log
  - changeSet:
      id: 4-create-app-config
      author: your.name
      changes:
        - createTable:
            tableName: app_config
            columns:
              - column:
                  name: id
                  type: int
                  autoIncrement: true
                  constraints:
                    primaryKey: true
                    nullable: false
              - column:
                  name: setting_name
                  type: varchar(100)
      rollback:
        - dropTable:
            tableName: app_config

{
    "databaseChangeLog": [
        {
            "changeSet": {
                "id": "1-create-employees",
                "author": "your.name",
                "releases": "v1.0,v1.1",
                "changes": [
                    {
                        "createTable": {
                            "tableName": "employees",
                            "columns": [
                                {
                                    "column": {
                                        "name": "id",
                                        "type": "int",
                                        "autoIncrement": true,
                                        "constraints": {
                                            "primaryKey": true,
                                            "nullable": false
                                        }
                                    }
                                },
                                {
                                    "column": {
                                        "name": "name",
                                        "type": "varchar(100)"
                                    }
                                },
                                {
                                    "column": {
                                        "name": "department",
                                        "type": "varchar(50)"
                                    }
                                }
                            ]
                        }
                    }
                ],
                "rollback": [
                    {
                        "dropTable": {
                            "tableName": "employees"
                        }
                    }
                ]
            }
        },
        {
            "changeSet": {
                "id": "2-create-products",
                "author": "your.name",
                "releases": "v1.1",
                "changes": [
                    {
                        "createTable": {
                            "tableName": "products",
                            "columns": [
                                {
                                    "column": {
                                        "name": "id",
                                        "type": "int",
                                        "autoIncrement": true,
                                        "constraints": {
                                            "primaryKey": true,
                                            "nullable": false
                                        }
                                    }
                                },
                                {
                                    "column": {
                                        "name": "name",
                                        "type": "varchar(100)"
                                    }
                                },
                                {
                                    "column": {
                                        "name": "price",
                                        "type": "decimal(10,2)"
                                    }
                                }
                            ]
                        }
                    }
                ],
                "rollback": [
                    {
                        "dropTable": {
                            "tableName": "products"
                        }
                    }
                ]
            }
        },
        {
            "changeSet": {
                "id": "3-create-audit-log",
                "author": "your.name",
                "releases": "v2.0",
                "changes": [
                    {
                        "createTable": {
                            "tableName": "audit_log",
                            "columns": [
                                {
                                    "column": {
                                        "name": "id",
                                        "type": "int",
                                        "autoIncrement": true,
                                        "constraints": {
                                            "primaryKey": true,
                                            "nullable": false
                                        }
                                    }
                                },
                                {
                                    "column": {
                                        "name": "action",
                                        "type": "varchar(255)"
                                    }
                                },
                                {
                                    "column": {
                                        "name": "performed_at",
                                        "type": "timestamp"
                                    }
                                }
                            ]
                        }
                    }
                ],
                "rollback": [
                    {
                        "dropTable": {
                            "tableName": "audit_log"
                        }
                    }
                ]
            }
        },
        {
            "changeSet": {
                "id": "4-create-app-config",
                "author": "your.name",
                "changes": [
                    {
                        "createTable": {
                            "tableName": "app_config",
                            "columns": [
                                {
                                    "column": {
                                        "name": "id",
                                        "type": "int",
                                        "autoIncrement": true,
                                        "constraints": {
                                            "primaryKey": true,
                                            "nullable": false
                                        }
                                    }
                                },
                                {
                                    "column": {
                                        "name": "setting_name",
                                        "type": "varchar(100)"
                                    }
                                }
                            ]
                        }
                    }
                ],
                "rollback": [
                    {
                        "dropTable": {
                            "tableName": "app_config"
                        }
                    }
                ]
            }
        }
    ]
}

Filtering by releases

At runtime, pass the --releases-filter argument to run only the changesets whose releases attribute matches the filter value. Matching is a straight string comparison with no logical operators. Changesets without a releases attribute always run, even when a filter is specified. See releases-filter for matching rules, examples, and supported commands.

PreviousOnValidationFail NextReleases-filter

releases

Uses

Syntax

SQL

XML

YAML

JSON

Filtering by releases