NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #2928 most downloaded on Packagist
Contao image library
Last release 8 months ago
21 Jan 2026
Ships fairly regularly
a new release about every 5 months
Nearly every release is documented
notes for 24 of 24 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
28 releases · first in 2016
Handle missing attribute namespace in XMP. #112
Handle corrupt JSON files in deferred image storage. #110
One column per quarter.
Add support for resampling-filter option. #108
Fix unterminated entity reference error. #101
Deprecate ResizeConfiguration::MODE_PROPORTIONAL . #97
Switch to Symfony's version of the Path helper. #89
Fix resize calculation ending up with zero. #82
Add namespaced exceptions and a specific FileNotExistsException . #79
FileNotExistsException. #79Revert fix for Gmagick bug No encode delegate for this image format . #70
Handle JSON errors when decoding. #68
Compatibility with Symfony 5. [#62]
Add upgrade documentation (UPGRADE.md file).
Remove unnecessary interfaces. [#57]
Add support for multiple image formats in pictures. [#53]
Add skipIfDimensionsMatch flag to ResizeOptions. [#52]
Add deferred image resizing. [#50]
ext-libxml, ext-xmlreader and contao/imagine-svg.Fix bug with wrong file permissions. [#49]
Use atomic file operations to save images.
x descriptor for small source images. [#48]Support for version 0.2 of contao/imagine-svg.
contao/imagine-svg.Add compatibility with Symfony 4.0. [#42]
Prefix certain global functions. [contao/core-bundle#1103]
Add compatibility with imagine 0.7. [#35]
Make resizer path relative to cache dir. [#32]
Round resize configuration after scaling. [#31]
LC_NUMERIC locale. [#28]Add support for interlace option. [#24]
getDimensions() for SVG images. [#23]srcset attribute. [#21]Remove constructors from interfaces. [#10]
getUrl(). [#12]x descriptor on the real image size. [#18]Improve constructor arguments order of Image and Resizer.
Image and Resizer.Resizer methods as protected to be accessible by contao/core-bundle.Resizer::resize path argument to cacheDir.[Unreleased]: https://github.com/contao/image/compare/1.2.4...1.x [1.2.4]: https://github.com/contao/image/compare/1.2.3...1.2.4 [1.2.3]: https://gith
Your coding agent can read these notes before it upgrades. Set up the MCP server →