Guides
  1. Asset Processors

GZip and Image Support

How Nomad Media automatically extracts and processes images stored in .gz compressed archives.

In some cases, images will be stored in a .gz (GZIP format). This is a compression technique for files. In the specific case of images compressed with this format, Nomad Media will automatically extract the image from the archive and run the media processing pipeline on the original image. This allows for preview images, AI analysis, and image metadata to still be viewed and created — even though the file format is technically a compressed .gz file.

The following constraints apply:

  1. Only .gz files (not .zip) are supported.
  2. Only the Image media type is supported.
  3. TAR archive files are not supported inside the .gz archive. Only a single file inside the archive is supported.
  4. The filename must be in the format [image-name].[image-extension].gz. The image extension is required in the filename for proper decoding. For example, my-image.tif.gz is valid, but my-image.gz is not.
  5. The .gz file must not be larger than 100 MB.