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
  • Creates WebP thumb and preview variants after upload, so the original is available quickly while ChannelWeave corrects camera orientation, preserves aspect ratio, and avoids forced square stretch
  • Can run antivirus checks before storage when scanning is enabled
  • Supports 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
  • Matches new and renamed files to one unambiguous active Stock SKU in the background, with visible no-match, ambiguous and failed exceptions
  • 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 loads one page at a time 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
  • 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 Stock-item image rows.
  • New and renamed uploads enter a durable background matching queue. Exact sanitised SKU names take precedence; suffix names are linked only when they identify one active Stock item. Matches append to the Stock image manifest and skip existing URLs. You do not need to open each Stock item first.
  • Existing Stock image manifest links take precedence over filename-matching results. Linked images show Linked to stock, with Inactive stock (or Includes inactive stock) when applicable. Deactivating a Stock item or changing its SKU does not invalidate its existing image links.
  • The library counts linked images separately from unlinked files' pending, historical filename-matched, no-match, ambiguous and failed results. An image linked to several manifests is still counted once in the linked total.
  • Retry filename matching only requeues unlinked no-match, ambiguous and failed files. Correct an unmatched filename or active Stock SKU first; inactive Stock items remain excluded from automatic filename matching. Multiple candidate SKUs remain for review rather than being guessed. Sync from Media library on an individual Stock item remains available for a deliberate item-level refresh.
  • Each background claim has a five-minute lease and at most three automatic attempts. A restart recovers expired work without taking an unexpired claim; explicitly removed Stock-image links are not silently recreated by the background worker.
  • Filename matched without a current manifest link describes the historical matching result, not a current stock association. Reading the library does not rewrite that result or restore a removed link.
  • 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 catalogue
    • 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
  • You can select a larger photography intake: the browser sends consecutive batches within both request limits and shows progress between them. If one batch fails, completed batches stay uploaded and the remaining files stay selected for retry; there is no all-or-nothing claim across the whole intake.
  • Uploads are checked by file bytes, not only by extension or browser-declared content type
  • Originals are available immediately; thumbnails and previews appear as their background processing completes.
  • 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.