> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Image

> Uploaded images, with optional dimensions and a built-in cropper.

## Overview

An Image property is a File property specialised for pictures: it previews
inline, defaults to accepting only image types, and can open a cropper after
each upload so everything lands at a consistent size. Pick it from **General**
in the property type list.

## Configuration

| Setting           | What it does                                                                  |
| ----------------- | ----------------------------------------------------------------------------- |
| Allowed types     | Image MIME patterns. Defaults to `image/*`.                                   |
| Maximum file size | Cap per image, in MB. Empty means no cap.                                     |
| Maximum files     | How many images the field holds. Empty means unlimited.                       |
| Width · Height    | Recommended output size in pixels. When the cropper is on, it locks to these. |
| Enable cropper    | Opens an interactive cropper after each pick.                                 |

<Tip>
  Set width, height, **and** the cropper together when the image is going to be
  displayed at a fixed size, a logo or an avatar. Every upload then arrives
  pre-shaped instead of needing to be fixed later.
</Tip>

## What it stores

A reference to each uploaded image.

## See also

* [File](/data/properties/general/file): for non-image attachments.


## Related topics

- [Property Auto-Fill Agents](/ai/property-agents/overview.md)
- [email.opened](/dev/webhooks/events/email-opened.md)
- [Grid](/blocks/embedded/databases/grid.md)
- [Troubleshooting](/ai/property-agents/troubleshooting.md)
- [Presentation Themes](/blocks/presentations/themes.md)