Skip to content

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:

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.

Diagram