Image Style Description
This module adds a description field to image styles to clarify their intended use. This helps site administrators understand and manage different image styles more easily on the Image styles administration page. The descriptions are stored as configuration and are preserved even if the module is temporarily disabled.
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
- Go to Configuration › Media › Image styles (
/admin/config/media/image-styles). - Edit an existing style, or add a new one.
- Fill in the Description field. Something future-you (or someone else) will understand.
- Save. The description now appears on the listing.