Resize HEIC files
Resizing is usually the biggest lever for reducing HEIC file size.
Last updated: 2026-03-18
To resize HEIC files, run npx optimo photo.heic --resize <value>. Optimo supports three modes: percentage (50%), dimensions (w960), and target file size (150kB). Resizing reduces both dimensions and file size in one step — often more effective than compression alone.
Resize by percentage
Quick way to scale down when you don't know exact dimensions yet.
npx optimo photo.heic --resize 50%
Resize by dimensions
Cap width or height to match how the asset is displayed.
npx optimo photo.heic --resize w960
Use w for width and h for height.
Resize to a target file size
Useful for thumbnails and previews when you want predictable budgets.
npx optimo photo.heic --resize 150kB
Start with a budget you can ship everywhere, then adjust based on quality.
HEIC-specific tips
- Phone photos are often huge; resize first to the max display size.
- If you’re sending to the web, pick the target format as part of the steps.
- For sharing, `--resize w1920` is a common “good enough” cap.
Related pages
Frequently asked questions
- How do I resize HEIC files?
- Optimo supports three resize modes: percentage (--resize 50%), dimensions (--resize w960 or --resize h480), and target file size (--resize 150kB). Run "npx optimo photo.heic --resize <value>" to resize and optimize in one step.
- What is the best resize mode for HEIC?
- Use dimensions (--resize w960) when you know the display size. Use percentage (--resize 50%) for quick scaling. Use target file size (--resize 150kB) for thumbnails and budgets. Resizing is usually the single biggest lever for reducing HEIC file size.