Media library

Upload and manage tenant-scoped 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 tenant-scoped media path
  • shows canonical hosted URLs per file
  • generates WebP thumb and preview variants on upload for faster in-app image rendering (camera/EXIF orientation normalised, aspect ratio preserved, and no forced square stretch)
  • 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, and metadata stay readable
  • supports multi-select bulk actions for URL copy and delete
  • keeps files isolated per customer_id tenant

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

Tenant media URL pattern

Each tenant gets a dedicated base URL:

  • https://media.channelweave.com/products/<tenant-segment>/

Examples of generated file URLs:

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

How it ties into stock and drafts

  • Website draft image tools can use this same tenant 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 now prefer generated thumbnail/preview variants when the URL is in your tenant media path.
  • inventory and listing list views now 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 (tenant Media base URL + file names)
    • Paste full URL (tenant 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)