Detailed guide. An unofficial adaptation of User Guide 6.12. Source updated April 14, 2025; reviewed November 6, 2026. No running-Drupal procedure test has been performed.
Official source ↗ · Previous: 6.11 Changing Content Display · Chapter 6 overview · Next: 6.13 Setting Up an Image Style
Originals and derivatives
An image style applies effects such as scaling, cropping or grayscale to one original image, providing different display variations without replacing the original.
Generation and reuse
Configure effects at Configuration → Media → Image styles (/admin/config/media/image-styles). When a particular image is first requested in a style, Drupal applies the effects and saves the derivative. Later requests reuse that saved result. Core supplies effects; contributed modules may add others. Continue with 6.13
.
Security note and our checks
SA-CORE-2026-010 ↗ strengthens access checks for private derivatives served through non-core file schemes. This is not a claim that ordinary image styles universally disclose images. Custom stream wrappers may require corresponding extension changes. First fixes were 11.4.4, 11.3.14 and 10.6.13.
Verify original and derivative access separately, along with dimensions and first-request generation. A smaller displayed image does not itself make its original private.
Sources, credits and changes
Source: Drupal User Guide 6.12 ↗ . Contributors and source links listed in its Attributions: Boris Doesborg ↗ · Jojy Alphonso ↗ · Red Crackle · “Working with images” ↗ · Drupal Community Documentation ↗ . Refer to the source for writing, editing and adaptation roles, and to the guide-wide credits ↗ .
Copyright remains with the individual contributors; the official copyright page ↗ states © 2015–2025. Changes include reorganized explanations and procedures, our preparation and verification examples, troubleshooting notes, source-interpretation qualifications and release references. Original screenshots and videos are not reproduced. This adapted text is shared under CC BY-SA 2.0 . It is not an official edition or endorsement. This notice does not license unrelated articles or the site design.
Chapter navigation
Previous: 6.11 Changing Content Display · Chapter 6 overview · Next: 6.13 Setting Up an Image Style
Chapter 5 details · Chapter 7 details · All chapters · Search official information