Image Optimization

Learn how to perform on-the-fly image transformations using Medianova’s Image Optimization parameters and URL-based API.

Image Optimization and Resize Service allows you to manipulate and transform images dynamically by adding supported parameters to your CDN content path. You can resize, crop, rotate, optimize, and watermark images directly via URL — all processed at the CDN edge for minimal latency and maximum efficiency.

By offloading image processing from your origin to the CDN, you can reduce server load, save storage space, and improve end-user performance.

Each processed image is cached as a unique object. To purge transformed images, you must invalidate each variant individually.

Common Conventions

Item	Description
Base URL	https://{account}.mncdn.com/{module}/{parameters}/{path}/{image}.{ext}
Supported Formats	jpg, png
File Limits	Files larger than 10MB or exceeding 3000×3000 px will return 415 – Unsupported Media Type.
Cache Behavior	Each transformation (unique URL) is stored as a separate cache object.
WebP Output	Images may automatically be delivered as WebP depending on browser support.
Origin vs CDN URL Example	https://www.yourdomain.com/path/image.jpg → https://youraccount.mncdn.com/mnresize/400/300/path/image.jpg

You can test each operation by pasting its CDN URL directly into your browser.

Modules Reference

Each Image Optimization module operates independently through its own URL structure and parameters.

---

1. MNRESIZE — Image Resizing (Aspect Ratio Preserved)

Purpose Resize your images while preserving their original aspect ratio.

Syntax

https://{account}.mncdn.com/mnresize/{width}/{height}/{path}/{image}.{ext}

Parameters

Parameter	Description
width	Target width. Use - to auto-calculate height based on ratio.
height	Target height. Use - to auto-calculate width based on ratio.
path	(Optional) File path on the CDN.
ext	Image extension (jpg, png).

Examples

• https://youraccount.mncdn.com/mnresize/400/225/yourimage.jpeg → 400×225 output.

• https://youraccount.mncdn.com/mnresize/-/225/yourimage.jpeg → Auto width based on height.

• https://youraccount.mncdn.com/mnresize/400/-/yourimage.jpeg → Auto height based on width.

Note: This module maintains the original aspect ratio. To crop and resize simultaneously, use MNCROPRESIZE.

---

2. MNPADDING — Add Padding

Purpose Add uniform padding around the image using a HEX color code.

Syntax

https://{account}.mncdn.com/mnpadding/{width}/{height}/{hex_color}/{path}/{image}.{ext}

Parameters

Parameter	Description
width / height	Target dimensions including padding.
hex_color	Six-digit HEX color (without #). Example: C0C0C0.

Example https://youraccount.mncdn.com/mnpadding/400/125/C0C0C0/yourimage.jpeg

Tip: Use this feature to maintain image proportions inside fixed-size containers.

---

3. MNCROP — Crop Image

Purpose Crop the image by centering the original image within the target dimensions.

Syntax

https://{account}.mncdn.com/mncrop/{width}/{height}/{path}/{image}.{ext}

Example https://youraccount.mncdn.com/mncrop/400/300/yourimage.jpeg

Note: This operation crops only — no resizing occurs. To crop and resize in one step, use MNCROPRESIZE.

---

4. MNCROPRESIZE — Resize and Crop

Purpose Resize and crop the image simultaneously to reach target dimensions without distortion.

Syntax

https://{account}.mncdn.com/mncropresize/{width}/{height}/{path}/{image}.{ext}

Examples

• https://youraccount.mncdn.com/mncropresize/400/100/yourimage.jpeg

• https://youraccount.mncdn.com/mncropresize/200/225/yourimage.jpeg

Note: The module applies both MNRESIZE and MNCROP logic in one process.

---

5. MNOPTIMIZE — Image Optimization

Purpose Reduce the image file size while maintaining visual quality.

Details

• Optimizes without noticeable pixel or color degradation.

• Best results are achieved when original images are unoptimized (raw).

• You can enable optimization via the Medianova Control Panel under: CDN Resources → Optimization → Image Optimization

Tip: Combine MNOPTIMIZE with MNRESIZE for faster delivery and lower storage usage.

---

6. MNROTATE — Image Rotation

Purpose Rotate an image by 90, 180, or 270 degrees.

Syntax

https://{account}.mncdn.com/mnrotate/{angle}/{path}/{image}.{ext}

Example https://youraccount.mncdn.com/mnrotate/90/yourimage.jpeg

Warning: The rotation module cannot be combined with other modules. Only the following angles are supported: 90, 180, 270.

---

7. MNWATERMARK — Apply Watermark

Purpose Add a predefined watermark image to all served images.

Details

• Contact Medianova Support to enable watermarking.

• Once activated, new images are automatically watermarked.

• For cached images, purge required to apply watermark retroactively.

• Supports transparent PNG watermark uploads.

Warning: Once watermarking is enabled, modules like MNROTATE and MNCROP cannot be applied to those images.

---

8. MNCUSTOMCROP — Custom Cropping by Coordinates

Purpose Crop a specific section of an image using exact pixel coordinates.

Syntax

https://{account}.mncdn.com/mncustomcrop/{width}/{height}/{x}/{y}/{path}/{image}.{ext}

Parameters

Parameter	Description
width / height	Dimensions of the cropped output.
x / y	Starting coordinates for the crop area.

Example https://youraccount.mncdn.com/mncustomcrop/800/1200/430/200/yourimage.jpeg

Tip: Useful for highlighting a specific region or object in large source images.

Compatibility & Limits

• Files larger than 10 MB or exceeding 3000×3000 px → 415 Unsupported Media Type.

• Supported file formats: jpg, png.

• Each URL variation is individually cached; purge accordingly.

• Watermark and rotation cannot be combined.

• Optimized images may be automatically converted to WebP when browser-supported.