Last updated: Oct-30-2024
Not all asset formats are supported for transformations. If an asset has a format that's not supported, an error message will be returned when applying transformations to it.
Keep this limitation in mind when creating named transformations and transformation presets that may be applied to assets by other users.
You can use the following tables to verify that an asset is supported for transformations.
Supported image formats
The table below summarizes the supported image formats.
Format | Extensions | Supported for Upload 1 | Supported for Transformations 2 |
---|---|---|---|
AI (Adobe Illustrator) | .ai | Yes | Yes |
animated AVIF | .avif | No | Yes 6 |
animated GIF | .gif | Yes | Yes |
animated PNG | .png | Yes | Yes |
animated WebP | .webp | Yes | Yes |
AVIF | .avif | Yes | Yes 6 |
BMP | .bmp | Yes | Yes |
BW (Browzwear file) | .bw | Yes | Yes |
DjVu | .djvu | Yes | No |
DNG (Digital Negative) | .dng | Yes | No |
EPS (Encapsulated PostScript) | .ps, .ept, .eps, .eps3 | Yes | Yes |
FBX (Filmbox) | .fbx 7 | Yes 5 | Yes |
FLIF (Free Lossless Image Format) | .flif | Yes | Yes |
GIF | .gif | Yes | Yes |
GLB (Binary glTF) | .glb | Yes | Yes |
glTF (GL Transmission Format) | .gltf | Yes 5 | Yes |
HEIF | .heif, .heic | Yes | Yes |
ICO | .ico | Yes | Yes |
InDesign | .indd | Yes | Yes 3 |
JPEG | .jpg, .jpe, .jpeg | Yes | Yes |
JPEG 2000 | .jp2 | Yes | Yes |
JPEG XR (JPEG eXtended Range) | .wdp, .jxr, .hdp | Yes | Yes |
JXL (JPEG XL) | .jxl | Yes | Yes |
OBJ | .obj 7 | Yes | Yes |
Yes | Yes | ||
PLY | .ply | Yes | Yes |
PNG | .png | Yes | Yes |
PSD (PhotoShop Document) | .psd | Yes | Yes 4 |
Raw image files | .arw, .cr2, .cr3 | Yes | No |
SVG | .svg | Yes | Yes |
TARGA (Truevision TGA) | .tga | Yes | Yes |
TIFF | .tif, .tiff | Yes | Yes |
U3MA (Fabric file) | .u3ma | Yes 5 | Yes |
USDZ | .usdz | Yes | Yes |
WebP | .webp | Yes | Yes |
Footnotes
- If a format is supported only for upload, then the delivery URL enables a user to download the original file in its original format, but you cannot apply transformation parameters.
-
If a format is supported for transformations, but the browser doesn't support displaying that format, you can either provide the transformation URL with the original format to enable users to download the file, or you can provide the URL with a different delivery format specified. In that case, Cloudinary applies the transformation to the original format and then converts the image to the requested format for delivery. For example, you could provide a transformation URL for a PhotoShop (.psd) image and specify
jpg
as the delivery format to display the resulting transformation in the browser. -
You can transform an InDesign file if you deliver it as an image format, such as
jpg
orpng
, but you cannot deliver anindd
file with transformations. -
All layers are flattened into a single image if no
page
parameter is specified. - Certain 3D file formats are supported for upload within a zip file containing other required files for the model, such as textures etc. Some transformations, such as converting to a video or image, are supported on the bundle as a whole. No transformations are currently supported on its contained assets. For further information see Transformations on 3D models.
-
Images converted to AVIF and animated AVIF from other formats use additional quota. Images exceeding 30 megapixels cannot be encoded to AVIF - ensure you scale them down first. You can request to enable AVIF and animated AVIF as possible formats to be delivered when automatic format selection (
f_auto
) is used. - You cannot convert a 3D model of a different format to FBX or OBJ.
Supported video formats
The table below summarizes the supported video formats.
Format | Extensions | Supported for Upload1 | Supported for Delivery | Default Codec |
---|---|---|---|---|
3G2 | 3g2 | Yes | ||
3GP (3rd Generation Partnership) | 3gp | Yes | ||
AVI (Audio Video Interleave) | avi | Yes | ||
FLV (Flash Video) | flv | Yes | No 2 | |
HLS adaptive streaming | m3u8 | Yes (as raw file only) | Yes 3 | Defined by streaming profile |
MPEG-2 Transport Stream | ts, m2ts, mts | Yes | Yes | Defined by streaming profile |
MOV | mov | Yes | Yes | h264 |
MKV (Matroska Multimedia Container) | mkv | Yes | Yes | |
MP4 | mp4 | Yes | Yes | h264 |
MPEG-2 | mpeg | Yes | ||
MPEG-DASH adaptive streaming | mpd | Yes (as raw file only) | Yes 3 | Defined by streaming profile |
MXF (Material eXchange Format) | mxf | Yes | ||
OGV (Ogg Video) | ogv | Yes | Yes | |
WebM | webm | Yes | Yes | VP9 |
WMV (Windows Media Video) | wmv | Yes | VP9 4 |
Footnotes
- If a format is only supported for upload, then the delivery URL enables a user to download the original file in its original format, but you cannot apply transformation parameters. If you want to apply transformations, you can transcode the video to a different format for delivery.
- The FLV format has been deprecated by Adobe, however you can deliver existing FLV files as other formats.
- For adaptive streaming manifest files (m3u8 and mpd), only those generated using Cloudinary can be used for delivery. See Adaptive Bitrate streaming for more information.
- The default codec for WebM is VP9. For older accounts the default is VP8. Submit a support request to change this default.
Supported audio formats
The table below summarizes the supported audio formats.
Format | Extensions | Supported for Upload | Supported for Delivery |
---|---|---|---|
AAC (Advanced Audio Coding) | aac | Yes | Yes |
AIFF (Audio Interchange File Format) | aiff | Yes | Yes |
AMR (Adaptive Multi-Rate) | amr | Yes | |
FLAC (Free Lossless Audio Codec) | flac | Yes | |
M4A | m4a | Yes | Yes |
MP3 (MPEG-3) | mp3 | Yes | Yes |
OGG | ogg | Yes | Yes |
OPUS | opus | Yes | |
WAV (Waveform Audio File Format) | wav | Yes | Yes |
✖️