Migration Guides per Series
The following guides are meant to help you upgrading an existing application using Hibernate ORM to a more recent version. These guides are not automatically generated, but structured to give you the high level overview.
8.0
8.0.0.Beta1 2026-06-16 development
Jakarta Persistence 4.0
7.4
7.4.5.Final 2026-07-12 latest stable
@Temporal, @Audited, Limits & fetch joins, hbm.xml transformation, CacheMode.REFRESH_SESSION
7.3
7.3.13.Final 2026-08-02 end-of-life
@NaturalIdClass, tenant-specific credentials, entities and embeddables with no default constructor, check constraints on List order columns
7.2
7.2.24.Final 2026-08-02 limited-support
Pessimistic Locking Improvements, @EmbeddedTable, FindMultipleOptions, Vector Support for SQL Server
7.1
7.1.35.Final 2026-08-02 limited-support
Resource Scanning, Locking Improvements
7.0
7.0.10.Final 2025-08-10 end-of-life
Apache License, Jakarta Persistence 3.2, Java 17, QuerySpecification, mapping.xsd, Hibernate Models
6.6
6.6.55.Final 2026-08-02 limited-support
Jakarta Data, @ConcreteProxy, Extended Array Support, Embeddable Inheritance
6.5
6.5.3.Final 2024-09-18 end-of-life
Java Time Handling, Configurable Query Cache Layout, records as @IdClass, auto-enabled Filters, Key-based Pagination, Jakarta Data (tech preview)
6.4
6.4.10.Final 2024-08-06 end-of-life
soft-delete, array functions, non-String tenant-id
6.3
6.3.1.Final 2023-09-19 end-of-life
Jakarta Persistence 3.1, query methods, finder methods
6.2
6.2.52.Final 2026-05-03 end-of-life
Jakarta Persistence 3.1, records, structs, value generation, partitioning, SQL MERGE
6.1
6.1.7.Final 2023-02-07 end-of-life
Subquery in FROM clause, JDBC Array support, Unified Mapping XSD
6.0
6.0.2.Final 2022-05-25 end-of-life
Performance, HQL, Criteria, Type System
5.6
5.6.15.Final 2023-02-06 end-of-life
Dropped support for Javassist, Performance
5.5
5.5.9.Final 2021-12-16 end-of-life
Introducing support for Jakarta JPA
5.4
5.4.33.Final 2021-12-16 end-of-life
EntityGraph improvements, JDK 11 support
5.3
5.3.39.Final 2026-06-29 end-of-life
JPA 2.2, inheritance caching
5.2
5.2.18.Final 2018-11-16 end-of-life
5.1
5.1.17.Final 2018-11-28 end-of-life
5.0
5.0.12.Final 2017-01-19 end-of-life
4.3
4.3.11.Final 2015-08-05 end-of-life
4.2
4.2.21.Final 2015-10-23 end-of-life
