Chapter 6: Media Manager & Central Asset Hub
Centralized Visual Asset Management, High-Efficiency Batch Uploading, Image SEO Metadata Optimization, and Universal In-Form Media Picker Integration.
6.1 All Media Gallery & Asset Workspace
High-converting e-commerce relies heavily on rich visual imagery. In MartX, media assets are not scattered across disconnected folders. Instead, the Media Manager serves as the central operational hub for all product photography, category icons, brand logos, hero banners, and brand storytelling visuals.
Navigate to: Admin Dashboard → Media Manager → All Media. To add new assets, click the + Add New Media button located in the top-right toolbar.
Gallery Toolbar & Display Capabilities
Select All & Bulk Delete
Admins can check Select All to highlight multiple obsolete files across the repository, followed by initiating an instant bulk deletion to free up server disk capacity.
Dual View Switching
Toggle between high-resolution Grid View (large visual image cards with file size indicators) and a compact List View for high-density catalog inspections.
Native WebP Thumbnails
Every uploaded file automatically displays its storage footprint (e.g. 20.01 KB, 60.18 KB), enabling administrators to identify oversized assets before publishing.
6.2 Batch Asset Upload Engine
Adding catalog items in bulk requires an ultra-fast asset ingestion pipeline. The Add New Media canvas allows administrators to batch upload dozens of product images, banners, or icons simultaneously through an asynchronous drag-and-drop dropzone.
Navigate to: Admin Dashboard → Media Manager → Add Media. Click the dashed upload box or drag multiple files directly from your desktop file explorer into the browser.
Ingestion Engine Technical Specifications
| Feature / Parameter | Supported Standard | Operational Behavior | Storefront Benefit |
|---|---|---|---|
| File Formats | WebP, SVG, PNG, JPG, JPEG, AVIF, GIF, BMP | Accepts modern web graphic standards including vector SVGs for crisp high-DPI brand logos. | Guarantees crisp graphics across retina smartphones, tablets, and ultra-wide desktops. |
| Batch Uploading | Multi-File Concurrency | Admins can drag up to 50 files simultaneously. Files are queued and processed asynchronously. | Speeds up new catalog and collection launches by up to 10x. |
| Upload Execution | Upload All Action Button | Validates file mime types and sanitizes file names on the server before database registration. | Prevents corrupted or unsafe binaries from entering the store storage disk. |
| Quick Return | ← Back to Media Gallery | Instantly navigates back to the central repository to inspect newly generated thumbnails. | Seamless operational loop without browser refresh lag. |
6.3 Asset Metadata & Image SEO Optimization
Image search accounts for over 20% of organic e-commerce discovery on Google. In MartX, administrators can inspect any asset's file metadata, verify its exact byte footprint, and configure descriptive Alt Text and contextual descriptions to boost SEO indexing and meet WCAG accessibility criteria.
Navigate to: Admin Dashboard → Media Manager → All Media → Click on any image card or its edit action to open the Edit Media workspace.
Media Information Field Anatomy & Validation
| Attribute / Field | Type & Constraints | Functional Description | Storefront & SEO Impact |
|---|---|---|---|
| Media Preview | Visual Canvas | Displays the actual rendered asset with exact aspect ratio containment and background contrast. | Ensures correct orientation and visual clarity before linking to products. |
| File Size & Date | Read-Only Telemetry | Shows the exact file size (e.g. 22.19 KB) and timestamped upload date (e.g. 08 Sep, 2026). |
Helps store managers audit and maintain high website page load speeds. |
| Name * | string (required)Unique Identifier |
The unique human-readable system label and physical storage filename. | Referenced in direct storage permalinks and CDN cache URLs. |
| Alt Text * | string (required)SEO Keyword String |
Alternative description of the visual subject (e.g., "prod-28-tote-beige", "waterproof-smartwatch-black"). | Injected into the HTML alt="" tag for Google Image search ranking and screen reader accessibility. |
| Description | text (optional)Free Textarea |
Internal administrative notes, photoshoot details, licensing source, or campaign season references. | Administrative reference only; not exposed publicly. |
6.4 Universal Media Picker Modal — Gallery Workspace
The most powerful feature of the MartX asset system is the Universal Media Picker Modal. Instead of navigating back and forth between different administrative screens, whenever an admin edits a Product, Slider, Banner, Category, Brand, or Team Member, clicking "Select Image" triggers this responsive modal instantly.
3-Step Modal Selection Workflow
6.5 Universal Media Picker Modal — In-Form Direct Upload
What happens if an administrator is halfway through writing a complex product description or configuring a promotional banner and discovers the required image has not yet been uploaded? In legacy platforms, users lose their work by navigating away. In MartX, the Upload New tab allows direct uploading inside the modal without losing a single character of unsaved form data.
When you drop an image into the Upload New tab and click Upload Media, MartX securely uploads the file via background AJAX, automatically adds it to the central library, and switches back to the Gallery tab with the newly uploaded image pre-selected. You can click Insert Media immediately!
6.6 Enterprise Asset Guidelines & Performance Hygiene
To ensure blazing-fast storefront page loads (under 1.2s on mobile devices) and top Core Web Vitals scores, adhere to these production asset standards when uploading media to MartX:
Modern WebP Adoption
Utilize WebP format for all catalog photography. WebP reduces file weights by 60% to 80% compared to legacy PNG/JPG while retaining 100% visual fidelity.
1:1 Aspect Ratio
Format product main images and team headshots in square ratios (e.g. 600x600 px or 800x800 px) to prevent irregular masonry jumps in storefront grids.
Descriptive Alt Text
Always provide meaningful Alt Text containing product colors, brand, and type (e.g. "women-leather-tote-bag-beige") to capture free Google Image traffic.
Periodic Bulk Hygiene
Every quarter, review the All Media gallery. Use Select All and Bulk Delete to purge expired seasonal banners and test uploads.
6.7 Enterprise Storage & CLI Maintenance Suite
For high-volume production stores managing tens of thousands of catalog assets, MartX includes a dedicated suite of headless Artisan CLI commands for server maintenance and scheduled automation:
| Artisan CLI Command | Execution Scope | Operational Purpose & Safety Flags |
|---|---|---|
php artisan media:clean |
Storage Disk Cleanup |
Scans the physical public/storage/media directory and purges orphaned files that no longer have corresponding records in the media database table.
Dry-Run Mode: Run
php artisan media:clean --dry-run to audit orphaned files without making disk changes.
|
php artisan media:vacuum |
Database Vacuum |
Purges dangling database rows in the media table whose physical asset files are missing from storage, restoring 100% database integrity.
|
php artisan media:optimize |
WebP Compression | Batch scans catalog images and generates modern WebP compressed variants to slash mobile page load times and improve Google Core Web Vitals. |
Recommended VPS Server Crontab
Server administrators can safely schedule automated weekly disk hygiene via standard crontab:
0 3 * * 0 cd /path-to-martx && php artisan media:clean --force >> /dev/null 2>&1