Skip to main content

Image Cadre & Crop

Category: Products  ·  Min plan: Free  ·  Slug: image-cadre

Adds a visual crop tool when uploading product images. Shows the exact storefront frame so you can resize and crop images to fit perfectly.

Features​

  • Visual crop tool on product image upload
  • Shows exact storefront frame overlay
  • Drag, zoom, and rotate to fit
  • Auto-detects theme aspect ratio
  • Skip button for quick uploads
  • Works on both create and edit pages

Why use it​

Different themes (brico, digital, prestige, showcase, starter) crop product images to different aspect ratios on storefront cards. If you upload a 4:3 photo and the theme expects 1:1 squares, the storefront cuts off the top or bottom — usually exactly the part you wanted to show.

This add-on overlays the storefront's actual cropping frame on your image right when you upload, so you can drag, zoom, and rotate the photo until the framing is right. No more re-uploading because the thumbnail looks wrong.

How to activate​

  1. Open Dashboard → Add-ons at /dashboard/addons.
  2. Find Image Cadre & Crop under Products.
  3. Click Activate (Free plan).
  4. The settings panel exposes:
    • Open cropper automatically (on by default) — opens the crop UI right after each image upload.
    • Output quality (75-100) — JPEG quality of the cropped output (default 90).

Using the cropper​

After activating, every product image upload at /dashboard/products/create and /dashboard/products/{id}/edit opens a modal with:

  • The image you just uploaded
  • A frame overlay matching the active theme's product-card aspect ratio
  • Drag to reposition
  • Pinch / scroll wheel to zoom
  • Rotation handle for tilted photos
  • Apply to save the cropped version
  • Skip to use the original (rare, but useful when you want the full uncropped image)

The original file is replaced with the cropped output server-side, so the storefront serves the right framing immediately.

Tips​

  • Set Output quality to 90 by default — drops file size significantly without visible quality loss. Push to 95-100 only for hero/cover images on premium-priced products.
  • The frame matches the active theme's aspect ratio. If you switch themes later, existing crops may need a redo on flagship products.
  • For products with one really good photo angle, use the rotation handle — saves you from going back to your photo editor.
  • Pairs naturally with the image_text variant type (small image + label) — the variant thumbnails inherit the cropped framing.