Resize Image — Reference
Change a loaded image’s dimensions, optionally retaining its aspect ratio.
Change a loaded image’s dimensions, optionally retaining its aspect ratio.
Before you begin
Section titled “Before you begin”- A supported image-processing runtime and a disposable test image. Load the named processing instance before effect, transform or Save steps.
Resize Image
Section titled “Resize Image”Change a loaded image’s dimensions, optionally retaining its aspect ratio.
Settings
Section titled “Settings”| Setting | Meaning |
|---|---|
| Image | Select the named Load Image instance available earlier in this action. It is not a filename or an App Connect page component. |
| Width | The target width in pixels. In Resize, auto leaves this dimension proportional to the supplied height; supported percentage values refer to the current image. Use positive integers for Crop and Cover examples. |
| Height | The target height in pixels. In Resize, auto leaves this dimension proportional to the supplied width; supported percentages refer to the current image. |
| Upscale | Allows enlarging the source when enabled. Default off. Enlargement does not create missing image detail. |
Worked example
Section titled “Worked example”For an 80 × 60 test image, set Width 40 and Height auto. Save to a new file and confirm 40 × 30. If both Width and Height are set to 40, the operation can stretch to 40 × 40 instead of cropping proportionally.
Check the result
Section titled “Check the result”Use one auto dimension to preserve aspect ratio. Upscale defaults off. The installed PHP implementation does nothing if a requested dimension would enlarge the image; Node.js delegates no-enlargement behavior to Sharp. Check the saved dimensions when the source is smaller than the requested result.
Load, transform and save
Section titled “Load, transform and save”Image Processor operations run on the server. For transformations, use a named Load Image, apply the intended operations to that instance, and Save it to a deliberate path. A page image component will not automatically update just because an in-memory server instance changed. Return or persist the saved path and update the page’s source as needed.
Check your result
Section titled “Check your result”You can configure the selected image operation and inspect a saved result for the intended dimensions or visual effect.