# FILE_TOO_LARGE

A file is too large.

- **HTTP class:** 413
- **Retryable:** no

## What happened

A file is over 4 MiB once decoded (or once its pieces are joined).

## Fix

Compress or resize it (WebP or AVIF for photos) and send it again. Video and audio aren't hosted: embed them from YouTube or Vimeo.

## What to tell the user

Mention which file was too big and how you made it smaller.

## Agent hint

The exact `error.hint` text; Carnival fills each `<…>` for the call.

```text
<path> is over 4 MB. Compress or resize it (WebP or AVIF for photos) and send it again.
```

## Related

- [`SITE_TOO_LARGE`](https://carnival-staging.dev/docs/errors/SITE_TOO_LARGE.md): The site is too large.
- [`PAYLOAD_TOO_LARGE`](https://carnival-staging.dev/docs/errors/PAYLOAD_TOO_LARGE.md): Too much data in one call.
- [`DISALLOWED_FILE_TYPE`](https://carnival-staging.dev/docs/errors/DISALLOWED_FILE_TYPE.md): This file type is not allowed.

All error codes: [error codes](https://carnival-staging.dev/docs/errors.md)