Migration Guides per Series
The following guides are meant to help you upgrading an existing application using Hibernate Search to a more recent version. These guides are not automatically generated, but structured to give you the high level overview.
8.4
8.4.0.Final 2026-05-27 latest stable
Upgrade to Hibernate ORM 7.4, compatibility with new versions of Elasticsearch/OpenSearch, other bugfixes, improvements and upgrades
8.3
8.3.2.Final 2026-05-24 limited-support
Upgrade to Hibernate ORM 7.3, compatibility with new versions of Elasticsearch/OpenSearch, other bugfixes, improvements and upgrades
8.2
8.2.2.Final 2026-02-18 limited-support
Pluggable Elasticsearch backend REST clients upgrade to Hibernate ORM 7.2, compatibility with new versions of Elasticsearch/OpenSearch, other bugfixes, improvements and upgrades
8.1
8.1.3.Final 2026-02-18 limited-support
Aggregation DSL improvements, platform BOMs, upgrade to Hibernate ORM 7.1 compatibility with new versions of Elasticsearch/OpenSearch, other bugfixes, improvements and upgrades
8.0
8.0.0.Final 2025-06-06 end-of-life
Integration with Hibernate ORM 7.0, metric aggregations, new Lucene-based backend, logging categories and more.
7.2
7.2.6.Final 2026-02-18 limited-support
Re-licensing as Apache License 2.0, query string predicates on numeric/date fields, analyzer API
7.1
7.1.2.Final 2024-08-30 end-of-life
Vector search, new query string predicate, simplified Standalone POJO mapper
7.0
7.0.1.Final 2024-04-10 end-of-life
Switch to Jakarta EE / ORM 6.4 without -orm6 artifacts, Hibernate Search BOM
6.2
6.2.5.Final 2026-02-18 limited-support
Standalone POJO Mapper, projection to custom (annotated) types, highlighting, excludePaths for @IndexedEmbedded, Elasticsearch schema export
6.1
6.1.8.Final 2023-01-31 end-of-life
Asynchronous, distributed automatic indexing, OpenSearch compatibility, conditional mass indexing, Jakarta EE / ORM 6 artifacts
6.0
6.0.11.Final 2023-01-31 end-of-life
API overhaul, safer and more concise Search DSL, more powerful bridges, smarter automatic indexing, nested documents
5.11
5.11.12.Final 2023-01-31 end-of-life
ORM 5.4 compatibility.
5.10
5.10.13.Final 2022-10-27 end-of-life
ORM 5.3 and JPA 2.2 compatibility, integration to DI frameworks through Hibernate ORM 5.3, upgrade to WildFly 17 and JGroups 4, JPMS automatic module names.
5.9
5.9.3.Final 2018-09-10 end-of-life
JSR 352 (Batch for Java) mass indexing job, WildFly feature packs, improvements and deprecations paving the road to Search 6
5.8
5.8.2.Final 2017-10-26 end-of-life
Experimental integration with Elasticsearch 5.x, AWS integration, improvements and deprecations paving the road to Search 6
5.7
5.7.3.Final 2017-10-26 end-of-life
Improved integration with Elasticsearch 2.x, compatible with Hibernate ORM 5.2.x
5.6
5.6.6.Final 2018-09-10 end-of-life
Introduces experimental support for Elasticsearch, last release supporting Hibernate ORM 5.0.z or 5.1.z
5.5
5.5.8.Final 2017-08-16 end-of-life
Being maintained as it’s included in WildFly. Supports Lucene only, requires Hibernate ORM 5.0.z or 5.1.z
5.4
5.4.0.Final 2015-09-03 end-of-life
Requires Hibernate ORM 5.0.0.Final; Last version compatible with Apache Lucene 4.x
5.3
5.3.0.Final 2015-06-10 end-of-life
Improved Faceting
5.2
5.2.1.Final 2015-09-04 end-of-life
Multi-tenancy, optimisations in criteria based loaders
5.1
5.1.2.Final 2015-04-24 end-of-life
Upgrade to Lucene 4 and much much more …
5.0
5.0.1.Final 2015-01-12 end-of-life
Upgrade to Lucene 4 and much much more …
4.5
4.5.3.Final 2015-01-12 end-of-life
Performance, WildFly 8 compatibility, JPA 2.1 / Hibernate ORM 4.3 compatibility
4.4
4.4.6.Final 2014-12-02 end-of-life
Dynamic index sharding, new Metadata API, Hibernate ORM 4.2.x compatible
Hibernate Search versions 3 and 4
Details to migrate from and between the various releases of Hibernate Search 3.x and 4.x are documented on our previous migration guide wiki. Please note these versions have not been maintained for a long time, so migrating to a more recent version is a very good idea.
