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.
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.