NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #428 most downloaded on Packagist
Associate files with Eloquent models
Last release 2 days ago
05 Oct 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
521 releases · first in 2015
Added functions to get a path to a file in the media library
Avoid creating empty conversions-directories
Fixed a bug where chaining the conversion convenience methods would not give the right result
One column per quarter.
Fixed a bug where getByModelType would return null
Images and pdf with capitalized extensions will now be recognized
Fixed: a rare issue where binding the command would fail
Added: methods to rename the media object and file name before adding a file to the collection
Fixed: updateMedia now returns updated media
updateMedia now returns updated mediaReplaced addMedia by a fluent interface
addMedia by a fluent interfacegetMedia will now return all media regardless of collectionhasMedia will count all media regardless of collectionAdded: hasMedia convenience method
Fixed: when renaming file_name on a media object the original file gets renamed as well
Fixed: use FQCN for facades instead of using the aliases
Fixed an issue where too many queries were executed
Added hasMediaWithoutConversions-interface
hasMediaWithoutConversions-interfaceFixes a bug where a valid UrlGenerator would not be recognized
Fixes a bug where an exception would be thrown when adding a pdf on systems without Imagick installed
Fixes some bugs where files would not be removed when deleting a media-object
Require correct version of spatie/string
Bugfix: correct typehint in HasMediaTrait
Added some convenience methods for some frequent used manipulations
- fix bug in regenerate command
This version is a complete rewrite. Though there are lots of breaking changes most features of v1 are retained. Notable new functions:
This version is a complete rewrite. Though there are lots of breaking changes most features of v1 are retained. Notable new functions:
Bugfix: prevent migration from being published multiple times
- Small bugfixes
Added: Spatie\MediaLibrary\Models\Media::getHumanReadableFileSize()
Spatie\MediaLibrary\Models\Media::getHumanReadableFileSize()Bugfix: make compatible with Laravel 5.1
Bugfix: Renamed the boot method of MediaLibraryModeltrait so it plays nice with the boot method of
Feature: The profile parameter in Media::getUrl() and MediaLibraryModelTrait::getUrl() is now optional. On null, it retrieves the original file's url.
profile parameter in Media::getUrl() and MediaLibraryModelTrait::getUrl() is now optional. On null, it retrieves the original file's url.Media::getOriginalUrl() now returns the correct url.Bugfix: Removed unnecessary static methods from MediaLibraryModelInterface
MediaLibraryModelInterfaceNothing published for this version
Nothing published for this version
Added a method to remove all media in a collection.
Fixed a bug where not all image profiles would be processed
getImageProfileProperties()to interfaceCreate the media library directory if it does not exist
Files without extensions are now allowed
Added check to make sure the file that must be added to the media library exists
Added option to specify the name of the queue that should be used to create image manipulations
- initial release
Nothing published for this version
Added the src option for the fm conversion parameter
src option for the fm conversion parameterAdded shouldDeletePreservingMedia
shouldDeletePreservingMediaYour coding agent can read these notes before it upgrades. Set up the MCP server →