---
title: 'Errors handling'
category: 'basics'
position: 4
---

# Errors handling

Whenever something goes wrong, TwicPics will issue an HTTP error with a sensible [status code](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes) and a short explanation in plain text as a body.

TwicPics will error when:

- There is a syntax error in the manipulation expression
- The authentication identifier is invalid
- The URL of the source asset is not well-formed, or its protocol is not supported
- The domain of the source asset is not registered (see the documentation about domain name registration)
- The source asset is unreachable (i.e., the `GET` request to retrieve it resulted in an HTTP error)
- The source asset is of an unsupported format (only [AVIF](<https://en.wikipedia.org/wiki/AV1#AV1_Image_File_Format_(AVIF)>), [GIF](https://en.wikipedia.org/wiki/GIF), [HEIF](https://en.wikipedia.org/wiki/High_Efficiency_Image_File_Format), [JPEG](https://en.wikipedia.org/wiki/JPEG), [PNG](https://en.wikipedia.org/wiki/Portable_Network_Graphics), and [WebP](https://en.wikipedia.org/wiki/WebP), and most `video` files are currently supported)
- The source asset, the output asset, or any intermediate asset created while processing the transformations doesn't respect the internal pixel and/or byte size limits of TwicPics (i.e., one of the assets has a dimension of zero or is "too big")
- A transformation ends up cropping outside of the asset (for instance, when attempting to crop 500 pixels out of an asset that is only 200 pixels wide)

<doc-alert type="info">Whenever an asset does not show on your web page, check the network tab of your favorite dev tool for those red-colored lines indicative of a network error.</doc-alert>