Detailed guide. An unofficial adaptation of User Guide 6.14. Source updated April 14, 2025; reviewed November 6, 2026. No running-Drupal procedure test has been performed.
Official source ↗ · Previous: 6.13 Setting Up an Image Style · Chapter 6 overview · Next: 6.15 Understanding Text Formats, Editors and XSS
Images suited to the display
The core Responsive Image module provides styles that help serve appropriately sized images for different screens, potentially reducing mobile transfer size and load time.
Mapping styles to breakpoints
A responsive image style maps image styles to breakpoints: points where a responsive design changes for screen size. It can use breakpoints from a theme or ones defined in responsive image style settings.
Select the resulting configuration in an image field’s display settings. Depending on configuration, output uses the HTML picture element or srcset and sizes attributes on img. An ordinary image style
defines transformations; a responsive style determines their use across display conditions.
Our verification examples
CSS-only resizing is different from actually downloading a smaller image. Check theme breakpoints, the formatter and the resource fetched at different widths. The source’s older Drupal 8 blog reference is background reading, not evidence of a procedure tested on current Drupal.
Sources, credits and changes
Source: Drupal User Guide 6.14 ↗ . Contributors and source links listed in its Attributions: Boris Doesborg ↗ · Responsive 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.13 Setting Up an Image Style · Chapter 6 overview · Next: 6.15 Understanding Text Formats, Editors and XSS
Chapter 5 details · Chapter 7 details · All chapters · Search official information