Images & Video

Overview

The media library is where MicroPIM keeps every product image and video. Upload files (or pull them in during import), edit images in a built-in visual editor, resize and download them in a range of ready-made sizes, optimize them to modern formats, and serve everything from highly available CDNs.

Every media file belongs to your organization and can be linked to one or more products, so each image also tells you which product galleries it appears in.

Navigation

Sidebar: Images & Video URL: /admin/media

The library offers both a paginated list view and a grid view (/admin/media/grid), with search and a type filter for images, videos, and documents.

What you can store

MicroPIM validates every upload against a fixed whitelist.

Type	Formats	Max size
Images	JPEG, PNG, GIF, WebP, SVG	10 MB (10–12000 px per side)
Videos	MP4, WebM, MOV, AVI, MKV	500 MB

Videos can also be added as video links rather than uploaded files — MicroPIM supports YouTube, Vimeo, and generic embed links, storing the provider and external video ID and redirecting to the provider’s player when the file is viewed.

Note

WebP and AVIF are handled as optimization output formats (see Image optimization). AVIF is not accepted as an upload format — upload JPEG, PNG, GIF, WebP, or SVG.

Stored fields

Field	Description
Name	Media file name
Description	Optional description, also used as the image alt text
MIME type	File type (e.g. image/jpeg, video/mp4)
Extension	File extension
Width / Height	Pixel dimensions (images)
Size	File size in bytes
Tags	Free-form tags for organizing media
Type	file (uploaded) or video_link
Storage provider	Where the file is stored
CDN path	Public CDN URL once uploaded
Primary	Whether the file is a product’s primary image

Product gallery association

Each media file records which products use it. Open a file’s edit page (/admin/media/{id}/edit) and MicroPIM shows every product whose gallery contains the image — including products that use it as a variation image — with a total product count and a linked list. This makes it easy to see, for any image, whether it is part of a product gallery and where.

One image per product can be flagged as the primary image; the rest form the product gallery.

Resize & Download

From an image’s edit page you can resize and download it without changing the original. Pick a preset size or enter a custom size.

Preset sizes:

Preset	Dimensions
Thumbnail	150 × 150
Small	300 × 300
Medium	600 × 600
Large	1200 × 1200
Instagram post	1080 × 1080
Instagram story	1080 × 1920
Facebook post	1200 × 630
LinkedIn post	1200 × 627
Twitter/X post	1200 × 675

For a custom size, enter a width and height (each 1–5000 px); aspect ratio is preserved by default. The resized file downloads immediately, keeping the original image’s format (a JPEG stays JPEG, a PNG stays PNG, and so on).

Image optimization

MicroPIM can convert images to modern, smaller formats on demand. From an image’s edit page, choose an optimization output and MicroPIM re-encodes the picture:

• WebP — convert to WebP
• AVIF — convert to AVIF
• Both — produce WebP and AVIF versions

Optimization runs in the background and saves each result as a new media file linked back to the original, so nothing is overwritten unless your settings say otherwise. Compression quality (default 85) and whether the original is deleted after a successful optimization are controlled in product settings.

Note

On-demand optimization is available only when image optimization is enabled in your organization’s product settings. JPEG, PNG, and GIF images are the usual candidates for conversion to WebP or AVIF.

Edit mode

Edit mode (/admin/media/{id}/edit-mode) opens a full visual image editor. Available only for images, it lets you:

• Crop, flip, and rotate
• Draw freehand and add shapes and icons
• Add text overlays — useful for labels, watermarks, and promotional badges
• Apply filters
• Undo and redo any change

When you’re done, Save Current overwrites the existing image, or Create New saves your edit as a separate media file.

CDN storage

MicroPIM uploads media to highly available content delivery networks so images and videos load fast worldwide:

• Cloudflare Images for images
• Cloudflare R2 for videos
• Amazon S3 as an automatic fallback

Each file tracks its upload state and its public CDN path. If an upload didn’t complete, the edit page shows the file as local-only and a Retry upload action re-queues it to the CDN.

Actions

• Upload — add new images or videos
• Edit — update a file’s name, description, and tags
• Edit mode — open the visual image editor
• Resize & Download — download a preset or custom-sized copy
• Optimize — convert to WebP and/or AVIF
• Retry upload — push a local file to the CDN
• Download — download the original file
• Delete — remove a media file

Related

• Media Import — how images arrive during product import
• Product Settings — image optimization, quality, and image-count rules
• Add Product — build a product gallery
• AI Tools — generate and enhance product imagery