Bulk Optimize Images Ability: Compress WordPress Media Library Images

Updated On : May 29, 2026By : Reading Time : 2 minutes

Key Takeaways

  • Nexter Bulk Optimize Images compresses images in the WordPress Media Library using configured Nexter Image Optimization settings.
  • Each processed image returns a result indicating success, skipped, or failed, along with bytes saved after optimization.
  • The default batch size for processing images is 5, and users can set a limit between 1 to 25 to avoid PHP execution timeouts.
Table of Contents

The nexter/bulk-optimize-images ability compresses images in your WordPress Media Library using your configured Nexter Image Optimization settings. You can target specific attachment IDs or let it process the next batch of unoptimized images automatically. This has the same effect as clicking Start Bulk Optimisation on Media > Bulk Images. Keep batch sizes small to avoid PHP timeouts.

Key Takeaways

This ability modifies image files on disk by compressing and replacing them with optimized versions.

Each processed image returns its own result: success, skipped, or failed, along with bytes saved.

If you omit attachment_ids, the ability processes the next unoptimized images automatically up to the limit value.

The default batch size is 5 images. Each image can take several seconds to process on the server.

The Image Optimization extension must be enabled in Nexter Extension before this ability can run.

Required Setup

The Image Optimization extension must be enabled in Nexter Extension settings. Call nexter/get-bulk-image-optimizer-status first to confirm unoptimized images exist. Use nexter/get-image-optimization to review your current compression settings before running.

Parameters

Both parameters are optional. If you omit both, the ability processes the next 5 unoptimized images from your Media Library.

attachment_ids (array of integers, optional) accepts specific Media Library attachment IDs to optimize. If omitted, the ability picks the next unoptimized images automatically.

limit (integer, optional) sets how many images to process when attachment_ids is omitted. Accepts 1 to 25. Defaults to 5. Keep this small to avoid PHP execution timeouts.

What It Returns

The ability returns a result object for each processed image in the batch.

status for each image: success, skipped, or failed.

bytes_saved for each successfully optimized image.

Per-image skip reasons that mirror what the Media u0026gt; Bulk Images dashboard shows.

When to Use This Ability

Compress a specific set of newly uploaded images by passing their attachment IDs directly.

Process the backlog of unoptimized images in small batches to avoid PHP server timeouts.

Build an automation that checks the queue with nexter/get-bulk-image-optimizer-status and then compresses images in batches.

Related Documentation

nexter/get-bulk-image-optimizer-status: Check the optimization queue and stats before running

nexter/restore-original-images: Roll back all optimized images to their originals

nexter/update-image-optimization: Configure compression format and quality settings

About the Author

sandip patel

WordPress Developer at POSIMYTH Innovations I am a passionate WordPress Developer at POSIMYTH Innovations, where I focus on building high-performance products and cutting-edge web experiences. Currently, I contribute to the development of major projects including The Plus Addons for Elementor, Sticky Header for Elementor, RankReady AI (LLM & SEO), and the SproutOS MCP server integration. I love bridging the gap between WordPress core functionality and modern AI capabilities. Beyond standard development.

Share your Thoughts

Get Instant Answers to all your questions about Nexter Blocks,
Extensions & Theme trained on 1000+ Docs and Videos

Still in Doubt? Let’s Assist You

Raise a ticket Now

Have Feedback or Questions?

Join our WordPress Community on Facebook!

Join Us

Related Docs

Content Protection for WordPress – Overview
icon
Create Code Snippet Ability: Add PHP CSS JS and HTML in WordPress
icon
Create Theme Builder Template Ability: Add Headers Footers and More in WordPress
icon
Delete Code Snippet Ability: Permanently Remove a Snippet in WordPress
icon
Delete Theme Builder Template Ability: Permanently Remove a Template in WordPress
icon
Get Bulk Image Optimizer Status Ability: Read Image Optimization Stats in WordPress
icon
123……………………21