---
title: "Max image size"
description: "Set a maximum image size users can upload through the built-in File Manager, keeping oversized images out of your emails."
url: https://docs.topol.io/email-editor/guide/max-image-size.html
---

# Max image size for image upload

**The `imageMaxSize` option caps the size of images uploaded through the built-in File Manager.** The limit is given in bytes and defaults to 2097152 (2 MB).

```ts
  imageMaxSize: 2097152, // 2MB in bytes
```

An upload above the limit is rejected with a notification and never reaches storage.

> **WARNING**
>
> The limit is checked after resizing and compression, so it applies to the file that would be stored rather than the one the user picked. A large image that compresses below the limit is accepted. Uploads handled by a [custom file manager](https://docs.topol.io/email-editor/guide/custom-filemanager.html) bypass the check entirely, since the built-in File Manager is what enforces it.

## Size reference guide

To help configure the limit accurately, here are a few byte conversions:

-   1MB = 1048576 bytes
-   2MB = 2097152 bytes
-   3MB = 3145728 bytes
-   5MB = 5242880 bytes