What's New in V5

V5 represents a near-complete rewrite of the Laravel-Elasticsearch package. This update delivers a more seamless integration with Laravel’s Models, Eloquent, and Query Builders while providing greater access to Elasticsearch’s advanced features.

New features

Laravel generated IDs:

• Ids can be generated on the Laravel side by using the GeneratesUuids or the GeneratesElasticIds trait. Docs

Query field map

• Field Maps can be defined in the model to map text to keyword fields, boosting performance Docs

Fluent query options as a callback

• All clauses in the query builder now accept an optional callback of Elasticsearch options to be applied to the clause. Docs

BelongsToMany Relationships

• BelongsToMany relationships are now supported. Docs

New queries

Three powerful new query methods have been added to simplify expressive search:

• whereMatch() Docs
• whereFuzzy() Docs
• whereScript() Docs

New aggregations

• Boxplot Aggregations Docs
• Stats Aggregations Docs
• Extended Stats Aggregations - Docs
• Cardinality Aggregations - Docs
• Median Absolute Deviation Aggregations - Docs
• Percentiles Aggregations - Docs
• String Stats Aggregations - Docs

Migrations: Add Normalizer

• Normalizers can now be defined in migrations. Docs

Direct Access to Elasticsearch PHP client

For low-level operations, you can access the native Elasticsearch PHP client directly:

Connection::on('elasticsearch')->elastic()->{clientMethod}();

V5 Under the Hood

This release is a complete architectural overhaul designed to mirror Laravel’s Eloquent ORM more closely.
The internals have been refactored for better testability, performance, and future extensibility.