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

  • 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 (aspect ratio preserved; no forced square stretch)
  • supports server-side file-name search and paged browsing for large libraries
  • 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 Library files table uses server-side pagination so the page stays responsive:

  • page sizes: 25, 50, 100, 250
  • sort by File, URL, Updated, and Size (ascending/descending)
  • checkbox-select rows with Bulk actions for:
    • Copy URLs (newline list)
    • Delete selected (single confirmation modal)
  • thumbnail preview column in the table (opens in a modal with Open original)
  • 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.
  • 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)