> ## Documentation Index
> Fetch the complete documentation index at: https://learn.workflow.dog/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Image Dimensions

> Read an image's pixel width, height, and aspect ratio.

**Get Image Dimensions** inspects an image without changing it.

| Direction | Field            | Type   | Description                                              |
| --------- | ---------------- | ------ | -------------------------------------------------------- |
| Input     | **Image**        | File   | The image to inspect.                                    |
| Output    | **Width**        | Number | Width in pixels.                                         |
| Output    | **Height**       | Number | Height in pixels.                                        |
| Output    | **Aspect Ratio** | Number | Width divided by height, rounded to four decimal places. |

Use the outputs to calculate safe crop coordinates, choose portrait or
landscape branches, or resize an image relative to its original dimensions.

The action fails when the file cannot be decoded as an image or its dimensions
cannot be determined.