Drupal is a registered trademark of Dries Buytaert
drupal 11.3.8 Update released for Drupal core (11.3.8)! 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)! video_embed_field 3.1.0 Minor update available for module video_embed_field (3.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). commerce 3.3.5 Minor update available for module commerce (3.3.5). geocoder 8.x-4.34 Minor update available for module geocoder (8.x-4.34). leaflet 10.4.5 Minor update available for module leaflet (10.4.5). 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).

Once you have a dozen image styles — Large (480×480), Max 1300x1300, Media Library thumbnail, and so on — you're left guessing which image style is actually used where, and why. This module adds a Description field to the image style add/edit form so you (or whoever inherits the site from you) can describe what each style is for. The description is then displayed on the Image styles admin page at /admin/config/media/image-styles

How it works

The description lives on the image style itself, stored as a third-party setting. That means it exports and imports cleanly with drush config:export and drush config:import like any other config — no separate table, no extra entity, nothing to migrate.

If you disable the module, your image styles keep working; the descriptions simply stop showing up on the listing. Re-enable it and they come back.

Installation

Install it like any other Drupal module:

composer require drupal/image_style_description
drush en image_style_description

Usage

  1. Go to Configuration › Media › Image styles (/admin/config/media/image-styles).
  2. Edit an existing style, or add a new one.
  3. Fill in the Description field. Something future-you (or someone else) will understand.
  4. Save. The description now appears on the listing.

Activity

Total releases
2
First release
Apr 2026
Latest release
1 day ago
Release cadence
0 days
Stability
50% stable

Releases

Version Type Release date
1.0.0 Stable Apr 20, 2026
1.0.x-dev Dev Apr 20, 2026