Documentation
Media guidelines for merchants
Recommended file sizes, formats, and aspect ratios for product images, banners, logos, and social previews.
File limits and formats
- Image upload limit: up to 15 MB per image
- General file/attachment limit: up to 10 MB
- Supported image formats: JPEG, PNG, WebP
- Product video: usually added as a video URL (not direct upload)
Recommended aspect ratios
| Asset type | Best ratio / size | Why |
|---|---|---|
| Product image | 1:1 (square) | Consistent product cards and cleaner catalog grids. |
| Homepage/content banner | 2:1 | Fits current preview/layout blocks without awkward crops. |
| Logo | 3:1 to 4:1 horizontal | Readable in nav and footer; use transparent PNG/WebP when possible. |
| OG/social image | 1200 × 630 (~1.91:1) | Best compatibility for Facebook, LinkedIn, and link previews. |
Merchant checklist
- Center your subject with safe margins for responsive crops.
- Keep style consistent across a category (lighting/background).
- Compress before upload for faster load times.
- Update top-selling SKUs first if you are fixing older mixed media.