imgix APIsRendering APIRotationOrientation

Orientation

orient

Changes the cardinal orientation of the image by overriding any Exif orientation metadata.

By default, when an image is transformed using any parameter, imgix automatically uses Exchangeable image file format (Exif) metadata present in the original image to orient your photos correctly. If your image does not contain Exif orientation data, we assume a value of 0 and do not rotate the image.

To override the Exif data, you can set the value either to 1 through 8 (following Exif format), or to 90, 180, 270, etc. as degree aliases for the Exif values where 90 = 6, 180 = 3, and 270 = 8. See the diagram below for how these values relate to the orientation of the image when it was shot.

exif sample

If you know that Exif data will not be present in the original image, you can instead use the rot parameter to rotate the image. One important distinction between the two is that orient is intended to correct the cardinal orientation of the image, whereas rot is intended for straightening the image (i.e. correcting camera tilt on a horizon line). Also, rot will rotate your image within the existing frame, whereas orient will rotate the frame as well.