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.

CompressX Basic Workflow

Jan 2, 2026 | Docs

A overview of how CompressX processes images from upload to optimized delivery.
This workflow applies to both the free and Pro versions and is designed to be predictable, safe, and easy to understand.

Stage 1. Image Upload

Images are uploaded using the native WordPress media workflow.
CompressX does not replace or interfere with the upload process.
All original images are preserved, and no changes are made during the upload itself.
Optimization always happens after the upload is complete.

Stage 2. Image Optimization

Once images are uploaded, CompressX applies optimization based on your configuration.
Image optimization can happen automatically on upload or be triggered manually when needed.

Optimization on Upload

When auto-optimization on upload is enabled, CompressX supports three execution modes:

Optimize Immediately on Upload

Images are optimized as soon as they are uploaded.

Tip
When optimizing immediately on upload, image display may appear slightly delayed.
This is expected behavior, as CompressX is optimizing the image in the background before delivery.
Delay Optimization on Upload (Pro)

Optimization is delayed for a short period after upload. This option is useful for websites that upload images in batches.

Scheduled Processing Window (Pro)

Optimization runs only within a defined time window.

  • Images uploaded outside the window are queued
  • Processing starts automatically when the schedule begins
  • Ideal for off-peak hours (e.g. overnight)

This helps minimize performance impact on live websites.

Manual Image Optimization

If auto-optimization on upload is disabled, images can still be optimized manually from the Media Library.

  • Select individual images
  • Trigger optimization on demand
  • Useful for testing, adjustments, or selective optimization

Manual optimization follows the same quality and breakpoint rules as automatic optimization.

Stage 3. Bulk Optimization

Bulk optimization is used to process existing images in your media library and custom folders.
CompressX supports different execution models depending on the version:

  • Free version
    Bulk optimization runs in the current browser session and requires the Bulk Optimization page to remain open during processing.
  • CompressX Pro
    Bulk optimization runs in the background and can be executed immediately or on a schedule.

Bulk optimization does not change how images are delivered.
It only determines how and when images are processed.

Stage 4. Image Delivery

After optimization, images are delivered automatically across your website.
CompressX adapts image delivery based on:

  • Screen size (desktop & mobile devices)
  • Supported image formats (such as WebP or AVIF)
Tip
Image URLs remain unchanged, and no changes are required in your content or theme.

Optimized images are served transparently to improve loading speed and overall performance.

Summary

The CompressX workflow follows a simple and safe model:

  • 1. Upload images using WordPress
  • 2. Apply optimization based on defined presets
  • 3. Process existing images when needed
  • 4. Deliver optimized images automatically

For most websites, the default workflow works well without additional configuration.