Global Environment & Output Format

This setting allows you to configure the core engine used for image processing and define which modern formats your images should be converted into.

• Auto-Optimize New Uploads
  When enabled, CompressX automatically processes every new image the moment it is uploaded to the media library, ensuring your site remains optimized without manual effort.
• Library to Process Images
  Choose the PHP extension used for optimization. You can select GD (widely compatible) or Imagick (recommended for higher quality and broader format support).
• Output Formats
  Define your target next-gen formats. You can enable WebP for universal modern support and AVIF for maximum compression and file size savings.

Image Quality Preset: General vs. Smart Compression

Choose how the plugin determines the quality level for your images. You can prioritize simple and site-wide consistency, or, move toward an intelligent and scalable approach that adapts to each image’s specific size and role.

• General Compression
  Applies a single, site-wide quality level (1-99) to every image. This is ideal for sites with uniform image types where predictability is preferred.
• Smart Compression
  Uses smart size-based presets to scale quality automatically — applying aggressive compression to large files (4MB+) while protecting small files (0-30KB) from pixelation. It also allows for specific quality overrides for WooCommerce Images (e.g., Product Featured vs. Gallery) and WordPress Standard Images (e.g., Site Logos vs. Sidebar) to ensure your brand’s visual integrity is maintained where it matters most.

General Settings

Configure how CompressX Pro delivers next-gen images to your visitors, and manage how the optimization engine interacts with your server’s resources to ensure maximum performance without over-utilization.

• Browser Compatibility
  Select the delivery method for next-gen formats. Use Rewrite Rules (server-level) for maximum performance or Picture Tags (HTML-level) for broader compatibility on servers like OpenLiteSpeed.
• Max Dimensions
  Set a maximum width or height to automatically downscale oversized original uploads, preventing a waste of disk space.
• EXIF Data
  Choose to strip metadata (like GPS and camera info) to reduce file size and increase privacy, or keep it for photography-heavy sites.
• Queue Throughput
  Adjust the batch size (e.g., 1, 5, or 20 images) per cycle to balance optimization speed with server stability.
• New Upload (Cron) & Prioritize Images
  Decide if optimization happens immediately, is delayed for a few minutes, or is scheduled for low-traffic hours. You can also prioritize images on pages that are currently receiving live traffic.

Include/Exclude Folders

Define the specific boundaries for the CompressX scanner to ensure only the necessary directories are processed.

• Exclude Folders (Media Library)
  Navigate your standard /uploads/ tree and exclude specific years or months to protect original assets from being converted.
• Custom Folders
  Go beyond the media library by including specific directories within /wp-content/, such as theme assets, UI icons, or folders generated by other plugins.

Others Settings

Take full control over optimization of your images by choosing which thumbnail sizes to process and enabling real-time stats and quick actions directly in your media library. You also have access to the global reset tool to safely remove all generated assets if you need to start fresh.

• Thumbnail Sizes to Process
  Select exactly which image sizes (Standard or Custom) CompressX pro should optimize to avoid processing unnecessary thumbnails.
• Media Library Display Options
  Choose which stats (disk Saved, thumbnails deleted) and action buttons (watermark, restore) appear in your media library list view.
• Remove Cache-Control “private”
  A quick compatibility fix for Cloudflare and other CDNs to ensure your optimized images are cached correctly at the edge.
• Delete Images Generated by CompressX
  A global cleanup tool that permanently removes all CompressX WebP/AVIF files and database records, allowing for a total optimization reset.