Media Import
Overview
Section titled “Overview”MicroPIM brings images into your media library as part of a product import. When you import or sync products from a connected platform, MicroPIM downloads each product’s images, stores them, links them to the product gallery, and uploads them to the CDN — all in the background.
Image import is controlled per product import and refined by your product settings.
How image import works
Section titled “How image import works”For each imported product image, MicroPIM:
- Downloads the image from the source URL (images only, up to 25 MB each).
- Creates a media file in your library and links it to the product’s gallery.
- Uploads it to the CDN (Cloudflare Images, with Amazon S3 as fallback) so it serves fast and reliably.
Downloads are idempotent — re-running an import won’t create duplicate copies of an image that has already been pulled in.
Turning image import on or off
Section titled “Turning image import on or off”Most integrations expose an Import images option on the import request (it is on by default). Turn it off to import product data without pulling images — useful when you only need text and pricing, or when you plan to manage imagery separately.
Some integrations also offer a dedicated re-import for images. For example, Shopify provides an Import images action that fetches images for products you’ve already imported, in batches.
Product settings that affect media
Section titled “Product settings that affect media”Your organization’s product settings shape how images behave across imports and the library:
| Setting | Effect |
|---|---|
| Require images | Whether products are expected to have at least one image |
| Minimum image count | The fewest images a product should have |
| Maximum image count | The most images kept per product gallery (default 10) |
| Image optimization enabled | Master switch for on-demand optimization |
| Optimization output | Convert images to WebP, AVIF, or both |
| Optimization quality | Compression quality for optimized images (default 85) |
| Delete originals after optimization | Whether the source file is removed once optimized |
After import
Section titled “After import”Once images are in your library you can:
- Edit them in edit mode — crop, rotate, add text or watermarks
- Resize & download them in preset or custom sizes
- Optimize them to WebP or AVIF
- See exactly which product galleries each image belongs to
Related
Section titled “Related”- Images & Video — the media library and editing tools
- Product Settings — image rules and optimization
- Import — importing products from files, feeds, and platforms
- Integrations — connect the platforms images are pulled from