Skip to main content
Product images on the ProductImage type include an is_cleaned_image flag. When true, the image has a square aspect ratio and a uniform background — ideal for product grids where raw retailer shots would mix on-model photos and mismatched aspect ratios.

​
Prefer cleaned images in grids

When displaying search or similar-product results, pick the cleaned image when one is available:
TypeScript
const heroImage = product.images.find(img => img.is_cleaned_image) ?? product.images[0];
This works on any product response that includes images — search, lookup, and product detail all expose the same ProductImage model.