Mamba helps speed up your storefront by optimizing product and catalog images. The Media tab lets you improve Largest Contentful Paint (LCP), compress images, convert to WebP, and process existing media in bulk. The system also checks your server for WebP support and configures Apache/Nginx rules where possible to ensure modern formats are served correctly.

---

LCP (Largest Contentful Paint) Optimization

What it does

• Prioritizes critical images (product, shop, category) so they load earlier and render faster

When to use

• Recommended for all stores to improve Core Web Vitals and perceived speed

---

Image Compression

Enable Image Compression

• Compresses WooCommerce product images on upload to reduce file size

Compression Type

• Lossy (recommended): Smallest files with minimal quality impact
• Lossless: No quality loss but larger file sizes

Quality Slider (JPEG/PNG)

• Choose 1–100 (higher = better quality, larger size)

Compress Full Size Images

• Optionally compress original full-size uploads as well as thumbnails
• Increases processing time and disk I/O, but maximizes savings

---

WebP Conversion

Enable WebP Conversion

• Converts JPEG/PNG to WebP on upload for faster delivery

WebP Quality

• Choose 1–100 (higher = better quality, larger size)

Convert Full Size Images

• Optionally convert original full-size uploads to WebP
• Adds processing time but ensures smaller assets across all sizes

Server Assistance

• Apache (.htaccess): Rules auto-managed where possible to serve WebP with fallbacks
• Nginx: Ready-made configuration snippet provided for manual setup

Capability Checks

• Verifies GD/Imagick WebP support
• If missing, a warning is shown and conversions are skipped until support is available

---

Bulk Operations (Process Existing Images)

Optimize All Images

• Runs compression and/or WebP conversion on the existing media library
• Uses the current settings (lossy/lossless, full-size enabled, etc.)

Revert Optimizations

• Option available to roll back previous image optimizations

Helpful Stats

• Shows totals, eligible images, already compressed, and converted to WebP
• Provides simple progress percentages for tracking

---

Server Support and Auto-Configuration

Apache-Compatible Servers

• If .htaccess is writable and WebP is enabled, rules are automatically added or healed
• Ensures browsers that support WebP get it; others receive JPEG/PNG

Nginx Servers

• Clear “Manual Required” notice with ready-to-use snippet:
  • Vary: Accept headers
  • try_files to serve .webp where supported
  • Correct MIME type and caching headers

WebP Generation Check

• Confirms if PHP image libraries support WebP
• Conversion settings remain saved but won’t run until support is available

---

Troubleshooting

• Images don’t serve as WebP
  → Check WebP support status. On Apache, confirm .htaccess rules are active; on Nginx, apply the provided snippet and reload. Clear CDN and browser caches.
• Visible quality drops
  → Raise the quality slider or switch to lossless mode for sensitive imagery.
• Bulk processing is slow
  → Run in batches during off-peak hours. Disable full-size conversions if heavy. Check PHP time and memory limits.
• Thumbnails look unchanged
  → Regeneration may be required if theme sizes changed. Upload optimization applies to new media; existing sizes need bulk processing.

---

Mamba’s Media Optimizations deliver quick wins (compression + WebP) while giving you long-term control through bulk processing and auto-healing server rules. Turn on the features that fit your store, validate image quality on a sample set, and roll out with confidence.