Drupal is a registered trademark of Dries Buytaert
drupal 11.3.7 — Update released for Drupal core (11.3.7)! drupal 11.2.11 — Update released for Drupal core (11.2.11)! drupal 10.6.7 — Update released for Drupal core (10.6.7)! drupal 10.5.9 — Update released for Drupal core (10.5.9)! cms 2.1.1 — Update released for Drupal core (2.1.1)! drupal 11.3.6 — Update released for Drupal core (11.3.6)! drupal 10.6.6 — Update released for Drupal core (10.6.6)! cms 2.1.0 — Update released for Drupal core (2.1.0)! bootstrap 8.x-3.40 — Minor update available for theme bootstrap (8.x-3.40). menu_link_attributes 8.x-1.7 — Minor update available for module menu_link_attributes (8.x-1.7). eca 3.1.1 — Minor update available for module eca (3.1.1). layout_paragraphs 2.1.3 — Minor update available for module layout_paragraphs (2.1.3). ai 1.3.3 — Minor update available for module ai (1.3.3). ai 1.2.14 — Minor update available for module ai (1.2.14). node_revision_delete 2.0.3 — Minor update available for module node_revision_delete (2.0.3). moderated_content_bulk_publish 2.0.52 — Minor update available for module moderated_content_bulk_publish (2.0.52). klaro 3.0.10 — Minor update available for module klaro (3.0.10). klaro 3.0.9 — Minor update available for module klaro (3.0.9). layout_paragraphs 2.1.2 — Minor update available for module layout_paragraphs (2.1.2). geofield_map 11.1.8 — Minor update available for module geofield_map (11.1.8).
← All modules

crop_or_fill

Security covered
View on drupal.org

Crop or Fill

Crop or Fill is an image effect that extends the Crop API module. It intelligently handles the mismatch between an image's orientation and the crop selection's orientation.

How it works

  • Same orientation (e.g. portrait image + portrait ratio): crops the image using the Crop API.
  • Opposite orientation (e.g. portrait image + landscape crop): instead of cropping, it creates a canvas matching the crop's aspect ratio, fills it with a configurable background color, and centers the original image on it. No pixels are lost.
  • Square crop: treated as "same orientation" — always crops normally.

Use case

A site has a "Hero" image style with a landscape crop type (16:9). An editor uploads a portrait photo. With the standard crop effect, the image would be severely cropped, losing most of the content. With Crop or Fill, the portrait photo is placed on a landscape canvas with colored bars on the sides — similar to letterboxing — preserving the entire image.

Configuration

  • Crop type: select which crop type to use (inherited from Crop API).
  • Background color: hex color picker for the fill bars (default: white).

Requirements

  • Crop API module
  • ImageMagick module — optional, for ImageMagick toolkit support. Both GD and ImageMagick toolkits are supported.

Activity

Total releases
4
First release
Feb 2026
Latest release
3 weeks ago
Release cadence
10 days
Stability
25% stable

Release Timeline

Releases

Version Type Release date
1.0.0 Stable Mar 25, 2026
1.0.0-rc2 Pre-release Feb 25, 2026
1.0.0-rc1 Pre-release Feb 24, 2026
1.x-dev Dev Feb 24, 2026