---
title: Resizing images on upload
related:
  - https://docs.kentico.com/k12sp/managing-website-content/working-with-files/editing-images.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

You can configure global image resizing in **Settings -> System -> Files -> Image resizing**.

The system automatically _**reduces**_ the size of images when they are uploaded according to the values that you fill in for the **Automatic image resize on upload (width, height, max side size)** settings:

- **No values are entered** - images are not resized.
- **Only width or only height** - images are resized so that their width or height matches the entered value. The other dimension is also resized to preserve the image's aspect ratio.
- **Both width and height** - both dimensions of images are resized according to the specified values (if the given dimension is greater than the entered value). Aspect ratio is not preserved.
- **Max side size** - if one of the image's sides is larger than this value, the image is resized so that its larger side's dimension matches the entered value. Aspect ratio is preserved and the width and height settings are not applied.

> **Info:** The image dimension values are measured in _**pixels.**_

![Configuring automatic image resizing](https://docs.kentico.com/docsassets/k12sp/resizing-images-on-upload/configuring_automatic_image_resizing.png "Configuring automatic image resizing")

These settings are applied by default when uploading images as:

- **media library files**
- **page attachments**
- **CMS.File pages**
- **Editable text web part** - uploading images using the [text editor](https://docs.kentico.com/k12sp/configuring-kentico/configuring-the-environment-for-content-editors/configuring-the-editor.md) dialogs.
- **Editable image web part** -uploading images using the **Select image** dialog.
- **Field editor fields** - uploading images using the following field types (form controls), for example in forms or the Page type field editor.

  - **File** data type -> **Upload file** and **Direct uploader** form controls.
  - **Text** data type -> **HTML Area (Formatted Fext)**, **BBcode editor**, **Image selection**, **Media selection** and **File selection** form controls.

The default settings defined here can be overridden by local settings in the particular parts of the user interface (e.g. web part properties, field editor, text editor dialogs, etc.).