Skip to main content

Rotate

Use the rotate transformation to rotate a delivered image variant.

Overview​

Rotate is useful when a generated or uploaded image needs a visual angle, when content orientation needs correction, or when you want to create a stylized layout variant.

When rotation exposes empty canvas space, provide a background color if the default background is not appropriate.

Syntax​

FieldValue
Canonical parameterrotate
Aliasrot
Value syntaxangle, angle:background, or an SDK object with angle and optional background

Example​

https://cdn.imgwire.dev/{organization_id}/{environment_id}/{image_id}?rotate=12:F3F4F6
image.url({
  rotate: '12:F3F4F6',
  format: 'auto',
  quality: 'auto',
});
imgwire images url img_123 --rotate 12:F3F4F6 --format auto --quality auto

Live examples​

Rotate -12OriginalRotate 12
Demo image rotated negative 12 degreesOriginal transformation demo imageDemo image rotated 12 degrees

Best practices​

  • Provide a background color when rotated corners are visible.
  • Use rotation sparingly in repeated UI layouts.
  • Combine rotate with explicit dimensions when the output must fit a stable layout.

Common mistakes​

  • Rotating images without checking the resulting canvas size.
  • Forgetting background color for exposed corners.
  • Using rotation to fix source orientation without checking whether the upload flow should handle orientation earlier.

Last updated at: May 9, 2026