[[structure-image-styles]]

=== Concept: Image Styles

[role="summary"]
Overview of image styles and how they are used to display a single image in
several variations.

(((Image style,overview)))
(((Style,image)))
(((Image effect,overview)))
(((Effect,image)))



==== Prerequisite knowledge

<<structure-fields>>


==== What are image styles?

Image styles allow you to upload a single image but display it in several ways;
each display variation, or _image style_, is the result of applying one or more
_effects_ to the original image.

As an example, you might upload a high-resolution image with a 4:3 aspect ratio,
and display it scaled down, square cropped, or black-and-white (or any
combination of these effects). The core software provides a way to do this
efficiently:

. Configure an image style with the desired effects on the _Image styles_ page
(_admin/config/media/image-styles_).

. The effects will be applied the first time a particular image is requested in
that style.

. The resulting image is saved.

. The next time that same style is requested, the saved image is retrieved
without the need to recalculate the effects.

The core software provides several effects that you can use to define styles;
others may be provided by contributed modules.

Visit the _Image styles_ page via the _Manage_ administrative menu, navigate to
_Configuration_ > _Media_ > _Image styles_ (_admin/config/media/image-styles_)
to see the image styles that are defined by default.

==== Related topics

* <<structure-image-style-create>>
* <<structure-image-responsive>>
* <<structure-fields>>


==== Additional resources

https://www.drupal.org/docs/8/core/modules/image/working-with-images[_Drupal.org_ community documentation page "Working with images in Drupal 7 and 8"]


*Attributions*

Adapted and edited by https://www.drupal.org/u/batigolix[Boris Doesborg],
and https://www.drupal.org/u/jojyja[Jojy Alphonso] at
http://redcrackle.com[Red Crackle], from
https://www.drupal.org/docs/8/core/modules/image/working-with-images["Working with images in
Drupal 7 and 8"],
copyright 2000-copyright_upper_year by the individual contributors to the
https://www.drupal.org/documentation[Drupal Community Documentation]
