Enlarge

Use the enlarge transformation to control whether Imgwire may upscale a delivered image variant beyond the source image size.

Overview

Enlargement affects resize requests where width, height, min-width, or min-height would produce an output larger than the uploaded source. Use it deliberately: upscaling can help fill a layout, but it can also make images look soft.

Syntax

Field	Value
Canonical parameter	enlarge
Alias	el
Accepted values	Boolean

Example

https://cdn.imgwire.dev/{organization_id}/{environment_id}/{image_id}?width=2400&height=1600&resizing_type=inside&enlarge=false

image.url({
  width: 2400,
  height: 1600,
  resizing_type: 'inside',
  enlarge: false,
  format: 'auto',
  quality: 'auto',
});

imgwire images url img_123 --width 2400 --height 1600 --resizing-type inside --enlarge false

Live examples

Upscaling prevented

Upscaling allowed

Best practices

• Leave enlargement disabled when visual sharpness matters more than filling a requested frame.
• Enable enlargement only for layouts where a larger delivered canvas is required.
• Test upscaled variants at the final rendered size before using them in production UI.

Common mistakes

• Upscaling small uploads into large hero images and expecting source-level detail.
• Confusing enlarge=false with cropping. It only prevents resize enlargement.
• Applying one enlargement policy to both thumbnails and full-width images without review.

Related pages

• Width
• Height
• Resizing Type

Last updated at: May 9, 2026