Imgix APIsRendering APIFormatIPTC Passthrough

IPTC Passthrough

iptc

When used, the iptc parameter determines whether IPTC/XMP metadata is preserved in the output image. Metadata passthrough is supported for JPEG, PNG, WebP, and AVIF output formats, including cross-format conversions (e.g., a JPEG input converted to WebP output).

Valid values are iptc=allow and iptc=block.

Usage

Setting iptc=allow will let IPTC/XMP data pass through for supported output formats (JPEG, PNG, WebP, and AVIF), whereas setting iptc=block will prevent any metadata from being passed through. By default, iptc=block is enabled when no parameter is specified.

This parameter can be configured by the Imgix support team to use any of the following default behaviors:

  • Always block IPTC data
  • Always passthrough IPTC data
  • Pass/block based on the URL parameter value (default option) For Always block or Always passthrough behavior, both can be overridden by including iptc=allow or iptc=block in the image URL.

Setting default IPTC/Exif data

The Imgix support team can set some default IPTC/Exif field values for all rendered images. This can be useful for forcing metadata to be served through the Rendering API.

  • IPTC Special Instructions: Instructions may include additional information about licenses or technical information for the needed end use of the image. Accepts up to 256 characters
  • Copyright: Information about the copyright holder of the image. Accepts up to 128 characters

Limitations

Default IPTC/Exif data will only be shown for files rendered through the Rendering API. Images served as a passthrough will not have default IPTC/Exif data applied.

If you would like this enabled on your account, contact your Account Manager or Support.