Skip to content

Image Styles

Philosophy: Configuration over code. Image styles and responsive image styles are config entities defined via YAML. The preferred workflow is config management, export/import, and recipes.

I Need To...

Task Guide
Understand when to use image styles vs responsive images Image System Overview
Know the full YAML config schema for image styles Image Style Config Schema
Configure resize, scale, crop, or conversion effects Core Image Effects
Create an image style via YAML config Creating Image Styles via Config
Set up a responsive image style with breakpoints Responsive Image Style Config
Define breakpoints in my theme Breakpoint Configuration
Configure image field formatters Image Field Formatters
Decide between art direction and resolution switching Art Direction vs Resolution Switching
Optimize images with WebP and AVIF WebP & AVIF Optimization
Generate derivatives or create custom effects programmatically Programmatic Image Operations
Export image styles or create a recipe Config Export & Recipes
Follow naming conventions and performance patterns Best Practices & Patterns
Avoid common mistakes Anti-Patterns & Common Mistakes
Secure image derivatives and optimize performance Security & Performance
Find key classes and interfaces Code Reference Map
Check sources and version history Sources & Maintenance