NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #4015 most downloaded on Packagist
Contao image library
Latest stable
1.2.4
Last release 10 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
Drag across the ruler to compare, or tap a release to open it.
Handle missing attribute namespace in XMP. #112
Handle corrupt JSON files in deferred image storage. #110
Add support for resampling-filter option. #108
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fix unterminated entity reference error. #101
Deprecate ResizeConfiguration::MODE_PROPORTIONAL. #97
ResizeConfiguration::MODE_PROPORTIONAL. #97getRawImg() and getRawSources() to Picture. #98Switch 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
No encode delegate for this image format. #70Handle JSON errors when decoding. #68
No encode delegate for this image format. #70contao/imagine-svg 1.0. #71Compatibility 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. #48Support for version 0.2 of contao/imagine-svg.
contao/imagine-svg.Add compatibility with Symfony 4.0, #42
Fix bug with wrong densities, #40
Add compatibility with imagine 0.7, #35
Make resizer path relative to cache dir, #32
Fix bug with LC_NUMERIC locale, #28
LC_NUMERIC locale, #28LC_NUMERIC locale. [#28]Added support for interlace option, #24
getDimensions() for SVG images. [#23]srcset attribute. [#21]Removed constructors from interfaces, #10
getUrl(). [#12]x descriptor on the real image size. [#18]Improved constructor arguments order of Image and Resizer
Image and ResizerResizer methods as protected to be accessible by contao/core-bundleResizer::resize path argument to cacheDirImage 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
One column per quarter.