Understand Image Statuses in LessFlux
Each image processed by LessFlux has a status that shows what happened to it. These statuses are the most reliable way to understand whether optimization is working or not.
If something doesn’t look right, checking the status is always the first step.
Why statuses matter
LessFlux runs in the background, so results are not instant. Status values help you understand:
- if a file is waiting to be processed
- if it was successfully optimized
- if something failed
- if the file was skipped or didn’t need optimization
Without checking statuses, it’s easy to assume the plugin is not working when it is simply still processing or behaving correctly.
Image status meanings
New
The image has been detected but has not started processing yet.
- normal immediately after upload
- temporary state before entering the queue
Pending
The image is in the queue and waiting to be processed.
- common during bulk optimization
- files will be processed automatically
Partially Processed
Only some versions of the image were optimized.
- WordPress generates multiple sizes
- some sizes may succeed while others fail or are skipped
Processed
The image has been successfully optimized.
- file size was reduced where possible
- this is the expected final state
Reverted
The image was restored to its original version.
- can happen if you manually revert changes
- optimized version is no longer active
Quota Exceeded
The image was not processed because your available quota has been reached.
- no tokens were available
- processing will resume after quota is restored
Failed
The image could not be processed due to an error.
- temporary issue or unsupported file
- check logs for more details
Could not process
The system attempted processing but could not complete it.
- file structure or format issue
- may require re-uploading or checking the file
No need for optimisation
The image was analyzed but did not require optimization.
- already optimized
- no meaningful size reduction possible
Ignored
The image was intentionally skipped based on your settings.
- format not selected for optimization
- image size excluded
Resource not found
The file could not be located when processing was attempted.
- file may have been deleted or moved
- database reference may be outdated
How to use statuses in practice
Statuses are most useful when verifying setup or diagnosing issues.
- after uploading a file, check that it moves from New or Pending to Processed
- if files are not optimized, look for Failed, Ignored, or Quota Exceeded
- use statuses to understand behavior instead of guessing
Common patterns to watch for
- many Pending files → queue is active, processing in progress
- many Ignored files → configuration is excluding them
- frequent Failed or Could not process → file or server issues
- Quota Exceeded → account limit reached
Recognizing these patterns helps you quickly identify what needs attention.
Best practices
- always check status after uploading a test image
- use logs to investigate failures
- review ignored files to confirm your settings are correct
- monitor quota usage regularly
Image statuses are the fastest way to confirm that LessFlux is working correctly and to understand what happens to each file.