Formats supported for transformations

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 GIF .gif Yes Yes
animated PNG .png Yes Yes
animated WebP .webp Yes Yes
AVIF .avif Yes Yes 9
BMP .bmp Yes Yes
BW (Browzwear file) .bw Yes Yes 6
DjVu .djvu Yes No
EPS (Encapsulated PostScript) .ps, .ept, .eps, .eps3 Yes Yes
FBX (Filmbox) .fbx 10 Yes Yes 6
FLIF (Free Lossless Image Format) .flif Yes Yes
GIF .gif Yes Yes
GLB (Binary glTF) .glb Yes Yes
glTF (GL Transmission Format) .gltf Yes Yes 6
HEIF .heif, .heic Yes Yes
ICO .ico Yes Yes
InDesign .indd Yes Yes 3
JPEG .jpg, .jpe, .jpeg Yes Yes
JPEG 2000 .jp2 4 Yes Yes
JPEG XR (JPEG eXtended Range) .wdp, .jxr, .hdp Yes Yes
OBJ .obj 10 Yes Yes 6
PDF .pdf Yes Yes
PLY .ply Yes Yes
PNG .png Yes Yes
PSD (PhotoShop Document) .psd Yes Yes 5
Raw image files .arw, .cr2 Yes No
SVG .svg Yes Yes
TARGA (Truevision TGA) .tga Yes Yes
TIFF .tif, .tiff Yes Yes
U3MA (Fabric file) .u3ma Yes Yes 6
USDZ .usdz Yes 7 No 8
WebP .webp Yes Yes

Footnotes

  1. 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.
  2. 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 stored in your account and specify jpg as the delivery format to display the resulting transformation in the browser.
  3. You can transform an InDesign file if you deliver it as an image format, such as jpg or png, but you cannot deliver an indd file with transformations.
  4. By default, when you request a jp2 image with a quality value less than 90, chroma sub-sampling (420) is automatically applied using Kakadu. You can also explicitly request chroma sub-sampling as part of your quality parameter. For example: q_90>:420.
  5. All layers are flattened into a single image if no page parameter is specified.
  6. The 3D format types are uploaded as a zip file. 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.
  7. USDZ files can only be uploaded as raw files.
  8. Transformations cannot be applied to USDZ files, but you can deliver any uploaded 3D model as a USDZ file.
  9. Images converted to AVIF from other formats use additional quota. Images exceeding 9 megapixels cannot be encoded to AVIF - ensure you scale them down first. If enabled, AVIF may be delivered when automatic format selection (f_auto) is used.
  10. 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 Yes
HLS adaptive streaming m3u8 Yes (as raw file only) Yes 2 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 2 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 3

Footnotes

  1. 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.
  2. 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.
  3. 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

✔️ Feedback sent!

Rate this page: