NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist, #284 most downloaded on Packagist
Supercharged Excel exports and imports in Laravel
Latest stable
4.0.7
Last release 5 days ago
17 Nov 2026
Release timing varies
gaps range from 8 days to 7 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
193 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
Move Boost skill examples and references inside skill folder by @hemreduru in #4455
Full Changelog: 4.0.6...4.0.7
Stop chunked imports at the WithLimit end row by @mkantautas in #4441
calculateFormulas in the Row cache key by @mkantautas in #4446Full Changelog: 4.0.5...4.0.6
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Honour SkipsUnknownSheets when importing in chunks by @mkantautas in #4439
Full Changelog: 4.0.4...4.0.5
Escape font names and plain values in RichTextReader::toHtml()
Full Changelog: 4.0.3...4.0.4
Replace deprecated SplObjectStorage::contains/attaach with offsetExis… by @negoziator in #4434
Full Changelog: 4.0.2...4.0.3
Fix Excel::fake() not working with ShouldBatch by @IonBazan in #4425
ChunkOffset/RemembersRowNumber properties to null by @zigzagdev in #4431Full Changelog: 4.0.1...4.0.2
[4.x] Add Time/Enum column types and sheet-level export concerns by @IonBazan in #4417
Full Changelog: 4.0.0...4.0.1
Fix 8.5 deprecation by @amooij in #4334
OnEachRow extend Import by @IonBazan in #4412Full Changelog: 3.1.70...4.0.0
See UPGRADE-4.x.md for the full upgrade guide.
WithColumns concern, describing a sheet as a list of typed column objects rather than raw arrays. Ships Text, Number, Decimal, Percentage, Price, Date, DateTime, Boolean, Formula, RichText, Hyperlink, Image and EmptyCell, each handling its own data type, number format, styling, sizing, filtering and comments on write, and its own casting on readFromScout export concern, replacing Scout builder support in FromQuery (#4390)ShouldBatch marker interface to dispatch queued exports and chunked queued imports as job batches (#4341)#[Queue] and #[Connection] attributes on imports (#4382)phpoffice/phpspreadsheet from ^1.30 to ^5.3 (#4302, #4333)Builder support in FromQuery, use FromScout instead (#4390)ext-json requirement (#4383)Update composer.json - Patch for CVE-2026-34084 by @marventhieme in #4387
Full Changelog: 3.1.69...3.1.70
Update minimum phpspreadsheet version to 1.30.4 ( CVE-2026-40296 ) by @gabrielrbarbosa in #4355
Full Changelog: 3.1.68...3.1.69
Fix: correct Laravel version range from 11.x to 12.x in compatibility by @ZakAmirou in https://github.com/SpartnerNL/Laravel-Excel/pull/4325
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.67...3.1.68
Phpspreadsheet 1.30 update Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.66...3.1.67
Phpspreadsheet 1.30 update
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.66...3.1.67
fix: missing InteractsWithQueue trait in QueueExport class by @KhoaDuongUQ in https://github.com/SpartnerNL/Laravel-Excel/pull/4314
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.65...3.1.66
Include end row in LimitFilter by @jivanf in https://github.com/SpartnerNL/Laravel-Excel/pull/4278
LimitFilter by @jivanf in https://github.com/SpartnerNL/Laravel-Excel/pull/4278SkipsOnError with OnEachRow by @stevebauman in https://github.com/SpartnerNL/Laravel-Excel/pull/4303Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.64...3.1.65
Revert "Exclude heading row when limiting imported rows" by @patrickbrouwers in https://github.com/SpartnerNL/Laravel-Excel/pull/4272
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.63...3.1.64
Update phpspreadsheet to 1.29.8 to tackle CVE issue by @brdv in https://github.com/SpartnerNL/Laravel-Excel/pull/4264
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.62...3.1.63
fix XXE notice by @aminetiyal in https://github.com/SpartnerNL/Laravel-Excel/pull/4257
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.61...3.1.62
Change parameters of NoTypeDetectedException because of php deprecati… by @dorep in https://github.com/SpartnerNL/Laravel-Excel/pull/4241
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.60...3.1.61
Bump phpspreadsheet to 1.29.4 Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.59...3.1.60
Bump phpspreadsheet to 1.29.4
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.59...3.1.60
Bump minimum version of Phpspreadsheet
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.58...3.1.59
Revert "Change filePath to real path if it's an upload (#4132)" by @isaacdew2 in https://github.com/SpartnerNL/Laravel-Excel/pull/4201
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.57...3.1.58
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.56...3.1.57
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.56...3.1.57
Change filePath to real path if it's an upload by @isaacdew2 in https://github.com/SpartnerNL/Laravel-Excel/pull/4132
Macroable to Excel and ExcelFake by @yoeriboven in https://github.com/SpartnerNL/Laravel-Excel/pull/4171Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.55...3.1.56
Bugfix for output buffer cleaning
Bugfix for output buffer cleaning
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.54...3.1.55
Detach cell parent when flushing cache to save memory
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.53...3.1.54
Backport never released features: cascade persisting of belongs* relations and builder macros
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.52...3.1.53
Fix mkdir recursive flag placement by @iftaras in https://github.com/SpartnerNL/Laravel-Excel/pull/4054
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.51...3.1.52
check if local path is valid before writing by @adamgoucher in https://github.com/SpartnerNL/Laravel-Excel/pull/4034
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.50...3.1.51
Allow setting default_ttl by @cosmastech in https://github.com/SpartnerNL/Laravel-Excel/pull/3980
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.49...3.1.50
Add multiple sheet support to WithChunkReading (fix #3938) by @benmag in https://github.com/SpartnerNL/Laravel-Excel/pull/3941
ReadChunk job by @dammy001 in https://github.com/SpartnerNL/Laravel-Excel/pull/3931ReadChunk queue and connection from impor… by @dammy001 in https://github.com/SpartnerNL/Laravel-Excel/pull/4002Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.48...3.1.49
Fix PHP 8.2 dynamic property deprecated by @faytekin in https://github.com/SpartnerNL/Laravel-Excel/pull/3880
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.47...3.1.48
fix bug #3865 by @chickgit in https://github.com/SpartnerNL/Laravel-Excel/pull/3873
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.46...3.1.47
Support Laravel 10 by @freekmurze in https://github.com/SpartnerNL/Laravel-Excel/pull/3860
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.45...3.1.46
Add support for ignoring PHP auto_detect_line_endings INI directive by @bram-dehart-nsgo in https://github.com/SpartnerNL/Laravel-Excel/pull/3813
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.44...3.1.45
Add test to check if WithFormatData works with SkipsEmptyRows by @svenbw in https://github.com/SpartnerNL/Laravel-Excel/pull/3761
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.43...3.1.44
WithFormatData in combination with SkipsEmptyRows (#3760)isEmptyWhen to customize is row empty logic. (#3645)required_unless rule (#3660)check that the $import variable is not empty by @douglasduarte in https://github.com/SpartnerNL/Laravel-Excel/pull/3745
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.42...3.1.43
Revert validation to array introduced in 3.1.41 by @mitchdesign in https://github.com/SpartnerNL/Laravel-Excel/pull/3742
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.41...3.1.42
Fix typo in excel.php file by @guiassemany in https://github.com/SpartnerNL/Laravel-Excel/pull/3613
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.40...3.1.41
Expose the ability to set custom response headers when exporting collections by @andrew-belac in https://github.com/SpartnerNL/Laravel-Excel/pull/3605
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.39...3.1.40
WithDefaultStyles concern to allow configuring the workbook default styles.WithBackgroundColor concern to allow configuring the workbook default background color.Fix PHP Deprecated #3588 by @J2TEAM in https://github.com/SpartnerNL/Laravel-Excel/pull/3599
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.38...3.1.39
Failing test for prepareForValidation not called with SkipsEmptyRows by @VFAndrew in https://github.com/SpartnerNL/Laravel-Excel/pull/3573
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.37...3.1.38
WithGroupedHeadingRow to allow imported sheets to group the values of columns with the same header in an arrayprepareForValidation callback not being called when using SkipsEmptyRows@squatto made their first contribution in https://github.com/SpartnerNL/Laravel-Excel/pull/3527
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/blob/3.1/CHANGELOG.md
@mixin docblock to all macroable classes to allow for IDE autocompletion of delegate classesExcel::toArray not allowing nullable reader types for uploaded filesFix return type of FromQuery::query() by @halloei in https://github.com/SpartnerNL/Laravel-Excel/pull/3485
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.35...3.1.36
FromQuery::query()Fixed range by @DominicVonk in https://github.com/SpartnerNL/Laravel-Excel/pull/3460
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.34...3.1.35
SkipsEmptyRows support with the WithColumnLimit concernFeature/refactor config local path by @khacnha in https://github.com/SpartnerNL/Laravel-Excel/pull/3329
Full Changelog: https://github.com/SpartnerNL/Laravel-Excel/compare/3.1.33...3.1.34
ToCollection and ToArray.Row's ArrayAccess implementationMake TransactionManager a singleton
Add assertExportedInRaw assertion
Custom heading row formatter can use column index
### Added - Octane compatibility
Fix AfterImport Event not being called
https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3128---2020-03-10
https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3128---2020-03-10
https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3127---2020-02-22
https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3127---2020-02-22
### Added - PHP 8 support
https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3125---2020-11-13
https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3125---2020-11-13
prepareRows method for your export class if needed.QueueExport job. Just add failed
method for your export class if needed.Illuminate\Contracts\Translation\HasLocalePreference for your export.JsonSerializable support in Maatwebsite\Excel\Validators\Failure.$maxExceptions support in Maatwebsite\Excel\Jobs\ReadChunk.php.WithUpserts concern.Added support for prepareForValidation on WithValidation concern
prepareForValidation on WithValidation concernwithValidator on WithValidation concernArrayAccess to RowRelease notes: https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3123---2020-09-29
Release notes: https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3123---2020-09-29
ignore_empty setting to config/excel.phpstrict_null_comparison setting to config/excel.phpChangelog: https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3122---2020-09-08
Changelog: https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3122---2020-09-08
Changelog: https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3121---2020-08-06
Changelog: https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3121---2020-08-06
Changelog: https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3120---2020-07-22 Release write up: https://medium.com/maatwebsite/new-m
Changelog: https://github.com/Maatwebsite/Laravel-Excel/blob/3.1/CHANGELOG.md#3120---2020-07-22 Release write up: https://medium.com/maatwebsite/new-milestone-20-million-downloads-for-laravel-excel-55f31ab562b4
BeforeSheet and AfterSheet events receiving exportable instance
instead of importable when calling on an Import.Older release notes can be found in Github releases.
Add fix for on each row and with validation
One column per quarter.