CompressX Documentation

Everything you need to install, configure, and get the best performance from CompressX Free and Pro.

CompressX Docs
Document Notice

Help Improve the Documentation

If you notice something unclear, outdated, or incorrect, feel free to let us know.

Your feedback helps keep the documentation accurate and useful for everyone.

Automatic Image Optimization on Upload

Jan 1, 2026 | Docs

The “Auto-optimize new uploads” function in CompressX Pro ensures that every new image added to your Media Library is processed without manual intervention. By configuring the cron settings, you can strike the perfect balance between instant image availability and server resource management.

How It Works

CompressX Pro monitors your WordPress Media Library for new uploads. When a new image is added, the plugin uses a background cron job to generate Next-Gen formats (WebP/AVIF) and apply your defined compression settings.

Quick Start: Setting Up Auto-Optimization on Upload

To set up auto-optimization for your new uploads, follow these step:

Step 1: Activating the Feature

First, enable the “Auto-optimize new uploads” function. This authorizes CompressX Pro to automatically trigger the optimization engine for all incoming assets.

  • 1. Go to CompressX → Image Optimization.

Image optimization page

  • 2. In the Global & Output Formats section, toggle on “Auto-optimize new uploads.”

Auto Optimize New Uploads

Step 2. Configure Processing Logic

Navigate to General Settings → New Upload (Cron) to define when the optimization should trigger. Choose the cron option that best fits your server capacity and workflow:

Auto Process New Uploads via Cron

  • Process immediately on upload
    This option triggers the optimization engine the moment an image is added to the library.
  • (Recommended) Delay processing
    This option defers the optimization by a specified amount of time (e.g., 3, 10, or 30 minutes after upload).
  • Scheduled processing window
    This option defines a specific daily time window (e.g., 01:00 to 06:00), any images uploaded during the day are queued and only processed during this window.
Note
Automatic optimization relies on WordPress Cron. Ensure your website cron system is working properly to trigger these tasks.

Step 3. Verify the Process

To confirm optimization is working, you can monitor the results directly in the media library or through the logs.

  • 1. Open the Media Library in List View.
  • 2. Look at the CompressX column.
  • 3. You should see the optimization results of new uploads (e.g., AVIF 323.67KB, Saved: 37.51% ).

Optimization Status in Media Library