Wonpa docs

Appearance

Image ratios and cropping ​

Product photos rarely arrive in one shape. Wonpa crops them to a uniform frame at display time, so a catalog shot in mixed portrait and landscape still lines up on the grid — you don't need to resize files before uploading.

There are two ratio controls, one for cards and one for the product gallery.

Product cards ​

  1. Open Theme settings → Product cards.
  2. Set Image ratio. Square keeps grids tightest; Portrait suits apparel; Adapt uses each image's natural shape (rows may vary in height).

This applies wherever cards render: collections, search results, featured collections, and recommendations.

Product page gallery ​

  1. In the theme editor, open a product page and select the Product section.
  2. Set Image ratio to Square, Portrait, or Landscape.

The gallery crops to the chosen frame with the image centered. Anything that doesn't fill the frame sits on a neutral background rather than stretching.

Product gallery cropped to a square frame

Note: Cropping is visual only. Zoom and the fullscreen lightbox still open the original uncropped image.

Corner rounding ​

Corner style is global, not per-image. Theme settings → Layout → Corner style offers four levels — Sharp, Standard, Soft, Round — and applies to images, cards, buttons, and inputs together so the storefront stays consistent.