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 blockorAlways passthroughbehavior, both can be overridden by includingiptc=alloworiptc=blockin 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.