---
title: Resizing images on upload
related:
  - https://docs.kentico.com/13/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 resizing for uploaded images 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.**_

These settings are applied by default when uploading images as:

- **media library files**
- **page attachments**
- **rich text page fields**– uploading images using the [rich text editor](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-the-editor-for-rich-text-fields.md) dialogs.
- **Field editor fields** – uploading images using the following field types (form controls):

  - **File** data type -> **Direct uploader** form control
  - **Text** data type -> **Media selection** form control

The default resizing settings can be overridden by local settings in the particular parts of the user interface (e.g. field editor, editor dialogs, etc.).