Media library

Upload and manage product images for stock manifests and draft reuse.

Last updated:

Use Media library to upload product images once, then reuse them across stock manifests and channel drafts.

Where to access it

  • Open the main app sidebar.
  • Select Media library.

What it does

  • Opens with the searchable image library first, with Upload images as a secondary page-header action that jumps to the upload panel below the library
  • Uploads image files into your account media library
  • Records file details such as content hash, size, content type, uploader, variant readiness, and delete state
  • Shows canonical hosted URLs per file
  • Validates uploaded image bytes before storage; file extensions and browser content types are not trusted
  • Blocks SVG uploads for safety
  • Keeps existing URLs stable by refusing silent overwrites; same-name collisions receive a short hash suffix
  • Queues WebP thumb and preview variant generation after upload, so the upload response returns quickly while the background worker normalises camera/EXIF orientation, preserves aspect ratio, and avoids forced square stretch
  • Can run antivirus checks before storage when scanning is enabled
  • Supports server-side file-name search and paged browsing for large libraries
  • Presents library files as thumbnail-led cards across desktop, tablet, and mobile, so file names, actions, processing status, scan status, and metadata stay readable
  • Lets you rename unused media files when you need to align existing uploads with SKU or stock-import naming before matching them to stock items
  • Supports multi-select bulk actions for URL copy and delete
  • Blocks rename and deletion while a file is still referenced by stock images, listing drafts, or published listing image rows
  • Keeps files isolated to your account

Large libraries (pagination)

When your media library contains many files, the card grid uses server-side pagination so the page stays responsive. Desktop shows a thumbnail-led card grid; tablet and mobile use compact cards instead of squeezing long URLs into a table:

  • Page sizes: 25, 50, 100, 250
  • Sort by File, URL, Updated, and Size (ascending/descending)
  • Card-level selection with Bulk actions for:
    • Copy URLs (newline list)
    • Delete selected (single confirmation modal)
  • Lazy-loaded thumbnails open in a modal with Open original
  • Full URLs stay behind explicit Open and Copy URL actions
  • Prev / Next navigation
  • Jump to a page number
  • Server-side search by file name

The page reads from ChannelWeave's media index rather than scanning the storage folder on every request. If an account still has older files that have not yet been indexed, ChannelWeave indexes those files once before showing the library.

Media URL pattern

Each customer account gets a dedicated base URL:

  • https://media.channelweave.com/products/<account-folder>/

Examples of generated file URLs:

  • https://media.channelweave.com/products/<account-folder>/ath-swim-00059.jpg

Media URLs are public-by-design product asset URLs. Treat them like storefront image URLs: do not upload private documents or confidential imagery.

How it ties into stock and drafts

  • Website draft image tools can use this same account base URL for file-name add flows.
  • Stock item images can be auto-synced from Media library by SKU file names (exact sku.ext and suffixed sku-*.ext) into product-level image rows.
  • For an empty stock image manifest, ChannelWeave attempts that SKU filename sync when stock images are first read. To associate additional matching media after a manifest already has images, upload files named like <sku>-<suffix>.<ext> and use Sync from Media library on the stock item; matching files are appended and existing image URLs are skipped.
  • Stock item image manifests can then be reordered per product and reused across channel draft flows.
  • Stock item image manifest cards and draft image rows use generated thumbnail/preview variants when the URL is in your account media path.
  • Inventory and listing list views use thumb variants for fast table previews:
    • Stock items
    • Low stock
    • Listings drafts
    • Listings
    • Allocated lines (stock cell)
  • List views do not auto-fallback to heavy original images when no thumb is available; they render a neutral placeholder instead.
  • Website draft → Images supports:
    • Upload images (sends files to Media library, then adds URLs to draft)
    • Add by file name (account Media base URL + file names)
    • Paste full URL (account Media URL only)
  • When a Website draft image list is empty and the draft is linked to stock, ChannelWeave auto-seeds the draft image list from linked product images.

Use SKU-based names to keep drafts predictable:

  • sku.jpg
  • sku-small.jpg, sku-large.jpg (when using suffix mode)

If a file with the same sanitised name already exists, ChannelWeave keeps the existing URL unchanged and stores the new file with a short content-hash suffix, for example sku-a1b2c3d4e5f6.jpg.

Renaming files

Use Rename on a media card when an uploaded file needs to match a stock item or SKU naming convention before import matching. Rename changes the file name and media URL for that unused asset, and ChannelWeave also moves its generated thumbnail and preview variants when they exist.

Rename is deliberately conservative:

  • The rename form lets you edit only the name before the extension; the existing image extension stays locked.
  • The new file name must be unique in your Media library.
  • Files already referenced by stock images, listing drafts, or published listing images cannot be renamed until those references are removed or replaced.

Upload limits and safety

  • File types: JPG, PNG, WEBP, GIF, AVIF
  • SVG uploads are blocked
  • Per-file limit: 20 MB
  • Per-request limit: 25 files and 100 MB total
  • Uploads are checked by file bytes, not only by extension or browser-declared content type
  • Variant generation is processed by the in-app media worker. Originals are available immediately; thumbnails/previews appear when the worker marks the asset ready.
  • When antivirus scanning is enabled, confirmed infected uploads are blocked before they become available in the library.

Delete safety

Media delete is reference-checked. ChannelWeave refuses deletion when a selected file is still used by:

  • a stock item image manifest
  • a listing draft image list
  • a published listing image list

Remove or replace those image references before deleting the media file.