Skip to main content

Min Height

Use the min-height transformation to ensure a delivered image variant is at least a target height.

Overview​

min-height only changes the output when the source image is shorter than the requested minimum. It is useful for normalizing image sets that include small uploads while leaving already-large images alone.

Syntax​

FieldValue
Canonical parametermin-height
Aliasesmh, min_height
Accepted valuesInteger pixels from 1 through 8192

Example​

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

Live examples​

Original heightMinimum height 1200
Original transformation demo imageDemo image delivered with minimum height of 1200 pixels

Best practices​

  • Use min-height for normalization, not for every fixed-size layout.
  • Pair it with enlarge=false when you want to avoid upscaling smaller source images.
  • Use height when the output should always be a specific height.

Common mistakes​

  • Expecting min-height to crop or pad. It resizes when the image is below the minimum.
  • Forgetting that upscaling can make small source images look soft.
  • Using min-height when a fixed Height and Resizing Type would be clearer.

Last updated at: May 9, 2026