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.

Bulk Optimization

Jan 1, 2026 | Docs

Manage large-scale library conversions with ease. This guide explores CompressX Pro’s bulk optimization modes—offering both instant foreground processing and scheduled background automation—alongside real-time monitoring and comprehensive task logging.

Bulk Optimization: Execution Modes

CompressX Pro provides two primary methods to scan and optimize your images in bulk, allowing you to choose the method that best fits your workflow and server capacity.

Bulk Optimization Modes

  • 1. Run Immediately in the Foreground
    The standard option for instant results and immediate library processing.
  • 2. Use Schedule to Process in the Background (Pro)
    Automates processing in the background, ideal for large libraries or restricted hosting environments.
Tip
Regardless of the mode chosen, you can toggle the “Force all images to be re-processed” option. This allows you to ignore previous optimization records and re-optimize your images based on updated quality or format settings.

Run Immediately in the Foreground

This mode triggers the optimization engine instantly. The system scans your media library for original JPG/PNG files and generates optimized WebP or AVIF versions in real time.

During processing, the interface shows real-time progress through visual counters and status bars. A live terminal monitors every file action, helping you track successful conversions or identify missing files as they occur.

Foreground Bulk Optimization

Note
When using the foreground mode, you must keep the page open until the process is complete to avoid interrupting the job.

Use Schedule to Process in the Background

Schedule the bulk processing of your images as a background task. This mode gives you the flexibility to start the job immediately or restrict it to a specific time window.

Bulk Optimization Schedules

  • Process immediately in the background
    Starts the job as soon as you initiate bulk optimization without requiring you to stay on the page. This is ideal if you want to start a large task but need to close your browser or work on other projects.
  • Process on a schedule
    Define a specific timeframe (e.g., 00:00 to 06:00) to restrict processing to low-traffic hours. This strategy minimizes the impact on server performance and visitor experience.
Note
When using the schedule mode, you can safely close the browser page or shut down your computer, the optimization continues to run on the server.

2. Image Comparison: Real-Time Results

The Image Comparison tool provides instant visual proof of the engine’s efficiency. As the bulk process runs, you can view a side-by-side comparison of the original images against their optimized counterparts.

Bulk Optimization Image Comparison

  • Format Switching
    You can switch between 3 comparison views: Original vs. WebP, Original vs. AVIF, or WebP vs. AVIF.
  • Data Transparency:
    Check exact file sizes and the total percentage of space saved, e.g., an original 69 KB file reduced to 34.16 KB for WebP (~50% smaller) or 27.94 KB for AVIF (~59% smaller).
Note
After the entire bulk job is finished, the last processed image remains visible in the comparison window for your review.

3. Recent 10 Logs: Historical Tracking

For better oversight, the dashboard maintains a quick-access list of the 10 most recent optimization logs. You can easily view recent task details, download log files for review, or delete them as needed.

Bulk Optimization Recent Ten Logs