NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #549 most downloaded on Packagist
Easily build Eloquent queries from API requests
Last release 1 months ago
03 Sep 2026
Release timing varies
gaps range from 8 days to 3 months
Most releases are documented
notes for 52 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
138 releases · first in 2018
Remove ignored values from array filter values by @danielebarbaro in #1071
Full Changelog: 7.3.4...7.3.5
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/7.3.4...7.3.5
One column per quarter.
Allow model-specific closures in AllowedFilter::callback() and AllowedSort::callback() by @Pronesti in #1070
Full Changelog: 7.3.3...7.3.4
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/7.3.3...7.3.4
Allow model-specific custom filters, sorts and includes by @freekmurze in #1069
Full Changelog: 7.3.2...7.3.3
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/7.3.2...7.3.3
Default direction getter for AllowedSort by @67cwr3ej in #1067
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/7.3.1...7.3.2
Bump actions/checkout from 5 to 6 by @dependabot [bot] in #1061
Full Changelog: 7.3.0...7.3.1
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/7.3.0...7.3.1
Bump dependabot/fetch-metadata from 3.0.0 to 3.1.0 by @dependabot [bot] in #1058
Full Changelog: 7.2.1...7.3.0
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/7.2.1...7.3.0
Add support for disabling global filter value splitting by @paulandroshchuk in #1056
Full Changelog: 7.2.0...7.2.1
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/7.2.0...7.2.1
Fix empty global delimiter causing a ValueError in query parameter parsing
ValueError in query parameter parsing (#1055)Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com
Co-Authored-By: Claude Opus 4.6 (1M context) noreply@anthropic.com
delimiter() method on AllowedFilterFix nullable filter edge cases for empty and not-null values with dynamic operators
v7: Modernized API and aggregate includes by @freekmurze in #1050
Full Changelog: 6.4.4...7.0.0
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.4.4...7.0.0
Fix TypeError when nullable operator filter receives null value by @isaackaara in #1048
Add Laravel 13 support
Add Laravel 13 support
Add generics to QueryBuilder class
Fix typo in docs by @zigzagdev in https://github.com/spatie/laravel-query-builder/pull/1040
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.4.0...6.4.1
Update README.md to reference v6 documentation pages by @cezar-popa in https://github.com/spatie/laravel-query-builder/pull/1033
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.3.6...6.4.0
Update reference to Laravel Pagination docs by @timmch in https://github.com/spatie/laravel-query-builder/pull/1015
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.3.5...6.3.6
Make nullable parameter types explicit to avoid deprecation warnings by @zigzagdev in https://github.com/spatie/laravel-query-builder/pull/1013
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.3.4...6.3.5
Improve QueryBuilder Generic Support by @liamduckett in https://github.com/spatie/laravel-query-builder/pull/1012
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.3.3...6.3.4
update some links so point to v6 docs by @KnudH in https://github.com/spatie/laravel-query-builder/pull/1004
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.3.2...6.3.3
Enhance QueryBuilder with generics support for better type inference by @alexkart in https://github.com/spatie/laravel-query-builder/pull/1002
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.3.1...6.3.2
General code health improvements by @xHeaven in https://github.com/spatie/laravel-query-builder/pull/988
.github folder and .php_cs from being included in composer installation by @stevebauman in https://github.com/spatie/laravel-query-builder/pull/993Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.3.0...6.3.1
Feature: Add "belongs to" filter by @gpibarra in https://github.com/spatie/laravel-query-builder/pull/975
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.2.3...6.3.0
Fix selecting fields on belongs to many relations by @rasmuscnielsen in https://github.com/spatie/laravel-query-builder/pull/986
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.2.2...6.2.3
Update filtering.md to clarify handling of array scope parameter by @g-gullstrand in https://github.com/spatie/laravel-query-builder/pull/976
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.2.1...6.2.2
Removed explicit escaping for pgsql driver in FiltersPartial - Fixes #941 by @Talpx1 in https://github.com/spatie/laravel-query-builder/pull/968
pgsql driver in FiltersPartial - Fixes #941 by @Talpx1 in https://github.com/spatie/laravel-query-builder/pull/968Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.2.0...6.2.1
[FEAT] add filter by operator by @AbdelrahmanBl in https://github.com/spatie/laravel-query-builder/pull/940
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.1.0...6.2.0
Bump ramsey/composer-install from 2 to 3 by @dependabot in https://github.com/spatie/laravel-query-builder/pull/939
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.0.1...6.1.0
Fix ability to filter models by an array as filter value by @inmula in https://github.com/spatie/laravel-query-builder/pull/943
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/6.0.0...6.0.1
Add additional types & Phpstan by @Nielsvanpach in https://github.com/spatie/laravel-query-builder/pull/910
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.8.1...6.0.0
Fix typo by @justinkekeocha in https://github.com/spatie/laravel-query-builder/pull/926
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.8.0...5.8.1
Bump: Deprecating Laravel 9 and PHP 8.1, adding Laravel 11 support by @JustSteveKing in https://github.com/spatie/laravel-query-builder/pull/922
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.7.0...5.8.0
Start testing against PHP 8.3 by @sergiy-petrov in https://github.com/spatie/laravel-query-builder/pull/899
allowedFields. by @carvemerson in https://github.com/spatie/laravel-query-builder/pull/917unsetDefault as a replacement for default(null) which was removed in 5.6.0 by @patrickrobrecht in https://github.com/spatie/laravel-query-builder/pull/902defaultSort function as documented by @MajidMohammadian in https://github.com/spatie/laravel-query-builder/pull/904disable_invalid_includes_query_exception config option by @dimzeta in https://github.com/spatie/laravel-query-builder/pull/906AllowedFilter.php to include getFilterClass function by @justasSendrauskas in https://github.com/spatie/laravel-query-builder/pull/909Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.6.0...5.7.0
Add support for defining includes by callback by @enricodelazzari in https://github.com/spatie/laravel-query-builder/pull/894
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.5.0...5.6.0
Add support for `withExists` via IncludedExists by @enricodelazzari in https://github.com/spatie/laravel-query-builder/pull/891
withExists via IncludedExists by @enricodelazzari in https://github.com/spatie/laravel-query-builder/pull/891QueryBuilder is used as a dependency in a package)Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.4.0...5.5.0
Deprecate request_data_source config. The QueryBuilder will always look at both the query string and the request body when available now
request_data_source config. The QueryBuilder will always look at both the query string and the request body when available nownull as the query parameter name for filters (see #889)Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.3.0...5.4.0
Accepts string value for the fields query parameter by @ezra-obiwale in https://github.com/spatie/laravel-query-builder/pull/872
fields query parameter by @ezra-obiwale in https://github.com/spatie/laravel-query-builder/pull/872FiltersEndsWithStrict filter by @utsavsomaiya in https://github.com/spatie/laravel-query-builder/pull/885allowedSorts are always set (even when none are requested) @luilliarcec in https://github.com/spatie/laravel-query-builder/pull/865Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.2.0...5.3.0
Bump dependabot/fetch-metadata from 1.3.5 to 1.3.6 by @dependabot in https://github.com/spatie/laravel-query-builder/pull/843
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.1.2...5.2.0
Update including-relationships.md by @designvoid in https://github.com/spatie/laravel-query-builder/pull/837
Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.1.1...5.1.2
Fix array_diff_assoc BC break in v5.1.0 by @stevebauman in https://github.com/spatie/laravel-query-builder/pull/827
array_diff_assoc BC break in v5.1.0 by @stevebauman in https://github.com/spatie/laravel-query-builder/pull/827Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.1.0...5.1.1
Feature: Update Generics in IncludeInterface by @sidigi in https://github.com/spatie/laravel-query-builder/pull/810
beginsWithStrict filter by @danilopinotti in https://github.com/spatie/laravel-query-builder/pull/821Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.0.3...5.1.0
[PHP 8.2] Fix ${var} string interpolation deprecation by @Ayesh in https://github.com/spatie/laravel-query-builder/pull/779
${var} string interpolation deprecation by @Ayesh in https://github.com/spatie/laravel-query-builder/pull/779__invoke() method of Filter by @kayw-geek in https://github.com/spatie/laravel-query-builder/pull/781Full Changelog: https://github.com/spatie/laravel-query-builder/compare/5.0.2...5.0.3
Nothing published for this version
Nothing published for this version
drop support for older versions
bugfix: appending to plucked values (that are not a Model) is not possible
plucked values (that are not a Model) is not possibleFull Changelog: https://github.com/spatie/laravel-query-builder/compare/4.0.3...4.0.4
Nothing published for this version
Nothing published for this version
revert deferred service provider
nested filters will no longer be automatically camel-cased to match a relationship name
Take a look at the upgrade guide for a more detailed explanation.
Nothing published for this version
Nothing published for this version
Nothing published for this version
- add callback sorts
add support for cursor pagination
fix unexpected lowercase appends
- no changes
fix simple paginator append not working
add support for custom includes
QueryBuilder (#621)prepend table name to WHERE clause for ambiguous partial filters
WHERE clause for ambiguous partial filters (#567)Your coding agent can read these notes before it upgrades. Set up the MCP server →