NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #436 most downloaded on Packagist
Associate files with Eloquent models
Last release 19 days ago
14 Sep 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
520 releases · first in 2015
improve handling of file names with special characters
added Spatie\MediaLibrary\MediaCollections\Models\Collections\MediaCollection
Spatie\MediaLibrary\MediaCollections\Models\Collections\MediaCollectionchanged freads to fgets as per issue #812
One column per quarter.
freads to fgets as per issue #812 (#1909)Unset loaded 'media' relation during updateMedia()
revert slash because of Vapor errors
set the media table name explicitly to media to avoid failure caused by doctrine/inflictor now using medias as the plural
media to avoid failure caused by doctrine/inflictor now using medias as the pluralfix for when using custom model
fixed duplicated path prefix for temporary urls
- fixed duplicated / in paths
/ in paths (#1854)do not allow local files to be used in addMediaFromUrl
addMediaFromUrladd page number support for Pdf image generator
add support for zip_filename_prefix in custom properties
zip_filename_prefix in custom properties- allow ZipStream 2.0
solve error when using flysystem-cached-adapter
- fix comment in config file
Use float for extractVideoFrameAtSecond
float for extractVideoFrameAtSecond (#1794)- update php-ffmpeg to ^0.15
add callable filter support to getFirstMedia()
getFirstMedia() (#1781)Nothing published for this version
set conversion disk when adding media from remote
an empty string is now a proper collection name. getMedia('') will not return media from the default collection anymore (#1697).
uuid on media tablegetMedia('') will not return media from the default collection anymore (#1697).root and url properties on a configured diskshouldMatchBothExtensionsAndMimeTypes to Spatie\MediaLibrary\ImageGenerators\BaseGeneratorUrlGenerator interface now contains all required methods (#1656)loading attribute (#1667)conversion_file_namer key in the media-library config file (#1636)To learn how to upgrade, take a look in UPGRADING.md
- add support for PHP 8
Nothing published for this version
Nothing published for this version
fix responsive images extension
- revert changes in 7.19.1
Update S3 url generator to use media disk
- add support for Laravel 7
allow image_driver config to be set via .env #1738
image_driver config to be set via .env #1738- add support for Laravel 7
revert of pull request #1604 because zip files could not be opened
add withResponsiveImages() to custom collection
withResponsiveImages() to custom collection (#1681)fix custom disk url giving invalid urls
added diskName on copy and move methods in media model
correctly use the media item's disk when removing responsive images
escape responsive URL - Fix issue #1659
add ability to upload files from a non-local disk
fix so files without extension could be added
generate the name of the converted file in one place
add a config option to version urls
add a way to define accepted mime types
tidy up getFallbackMediaUrl and getFallbackMediaPath
getFallbackMediaUrl and getFallbackMediaPath- fix media stream not working
fix upload for very large files
- remove imagick requirement
- add support for Laravel 6
Nothing published for this version
- do not export docs
add onlyKeepLatest on MediaCollection
onlyKeepLatest on MediaCollection- FileAdder now is macroable
FileAdder now is macroablemake sure CollectionHasBeenCleared will be called when using clearMediaCollectionExcept
CollectionHasBeenCleared will be called when using clearMediaCollectionExceptfix for custom manipulations not getting applied to all relevant conversions with the same name
make media collection macroable
add useFallbackUrl and useFallbackPath to media collections
useFallbackUrl and useFallbackPath to media collectionsavoid using deprecated str and arr functions
fix for S3 Responsive Image URL Generator not using root
allow stable version of zipstream
fix absolute references to media.id
Support jpeg in \Spatie\MediaLibrary\Conversion\Conversion::getResultExtension
jpeg in \Spatie\MediaLibrary\Conversion\Conversion::getResultExtensionAdd imagick as required extension, because of nested dependencies
Your coding agent can read these notes before it upgrades. Set up the MCP server →