> For the complete documentation index, see [llms.txt](https://docs.realmacsoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmacsoftware.com/squash/quick-guide/nodes/rotate.md).

# Rotate

Turn sideways and upside-down photos upright, automatically or by hand

The Rotate section fixes photos that are sideways or upside down. It turns images a quarter turn at a time, and it runs before every other setting, so crops, watermarks and borders are placed on the upright image.

Squash already shows photos the way the camera says they should be shown (their orientation tag), so most photos don't need Rotate. Use it for scans, screenshots and photos whose pixels really are sideways. Exported images are always saved upright, with no orientation tag.

### Auto-rotate

Turn on **Auto-rotate** to let Squash work out which way up each image is. It looks for faces, people and, when there are no people, text, and picks the way up where they appear upright.

Auto-rotate only turns an image when the answer is clear. When it isn't sure, it leaves the image as it is, because a wrong turn is worse than none. Images it turned show a **rotate badge** on their thumbnail in the list.

Auto-rotate uses Apple's Vision framework on your Mac. Nothing is uploaded.

### Rotate all

**Rotate all** turns every image by the same amount: **None**, **90° Right**, **180°** or **90° Left**. With Auto-rotate on, it's added after Auto-rotate's own turn. Choose **None** and turn off Auto-rotate to switch Rotate off.

### Rotating one image by hand

Select an image to show it in the [preview](/squash/quick-guide/editor.md). While Rotate is on, the bar floating at the bottom of the preview has a rotate button. Click it to turn the image left; hold **Option** to switch it to rotate right, and its icon and tooltip change to match. It turns only that image, and replace Auto-rotate's choice for it. Rotate the image back to where Auto-rotate had it to hand it back to Auto-rotate.

If the image also has a hand-made [crop](/squash/quick-guide/nodes/crop.md), the crop turns with it and keeps framing the same part of the picture.

Rotating by hand lasts until you remove the image from the list. It isn't saved in presets.

### Sizes and file names

Turning an image a quarter turn swaps its width and height. [Crop](/squash/quick-guide/nodes/crop.md) and [Resize](/squash/quick-guide/nodes/resize.md) work on the rotated image, so **Match orientation** in Crop follows the upright photo. Output sizes in the list, and file names that use the **{width}**, **{height}** and **{aspect}** tokens, use the rotated size.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmacsoftware.com/squash/quick-guide/nodes/rotate.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.