Rotate

You can rotate your image in a range clockwise from 0 degrees (no rotation) to 359 (nearly all the way around). You can also mirror an image horizontally or vertically. For more information see below.

Note: The maximum accepted image size is 100,000,000 pixels. An image with this many pixels could have width and height combinations like 10,000 x 10,000 or 5,000 x 20,000, etc. There is also a file size restriction. Filestack will not convert an image that is larger than 256mb. Please contact us if you require the ability to process larger files than our current limits.

Task Quick Jump:

Rotate Flip Flop


Rotate Task URL Formats:
https://process.filestackapi.com/rotate=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/rotate=[options]/File_URL
rotate=deg:0 to 359 or exif
Integer or String

Can be abbreviated as d:90

The degree by which to rotate the image clockwise. This can be an integer in a range from 0 to 359. Alternatively, you can set the degree to 'exif' and the image will be rotated based upon any exif metadata it may contain.

rotate=exif:false
Boolean

Can be abbreviated as e:false

Sets the EXIF orientation of the image to EXIF orientation 1. The exif=false parameter takes an image and sets the exif orientation to the first of the eight EXIF orientations. The image will behave as though it is contained in an html img tag if displayed in an application that supports EXIF orientations.

rotate=background:white or FFFFFFFF
Boolean

Can be abbreviated as b:black

Sets the background color to display if the image is rotated less than a fill 90 degrees. This can be the word for a color, or the hex color code. Click here for a list of accepted color names.

Rotate Examples

Original Image

This image has exif orientation data that corresponds to the 8th exif orientation (left-bottom).


Image rotated 180 degrees with deg:180:

image rotated 180 degrees clockwise with Filestack's image transformations

Image rotated 145 degrees with deg:145:

image rotated 145 degrees clockwise with Filestack's image transformations

Image rotated 145 degrees with a black background using deg:145,background:black:

image rotated 145 degrees clockwise and given a black background with Filestack's image transformations

Image rotated based on the image's exif orientation data (left-bottom) with deg:exif:

image rotated automatically to match its exif orientation data with Filestack's image transformations

Image displayed with exif=false parameter exif:false:

image displayed using the exif=false parameter which sets the exif orientation to the first position

Mirroring Images

Flip

Flip Task URL Formats:
https://process.filestackapi.com/flip/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/flip/File_URL
flip
String

flip

This task flips the image in the vertical direction. Flip requires no additional parameters. It is simply called like this: flip

Flip Example

Original Image

Original image to be transformed with Filestack's flip transformation

photo courtesy of Andrew Mione


Flip with default parameters flip:

image transformed with the flip transformation

Flop

Flip Task URL Formats:
https://process.filestackapi.com/flop/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/flop/File_URL
flop
String

flop

This task flops the image in the horizontal direction. Flop requires no additional parameters. It is simply called like this: flop

Flop Example

Original Image

original photo to be transformed with the flop transformation

Flop with default parameters flop:

image transformed with the flop transformation