WordPress filter hook · part of WordPress core

jpeg_quality

A WordPress core filter that 33 plugins also fire themselves, running on 1.5M+ sites between them.

“This filter is documented in wp-includes/class-wp-image-editor.php”

How to use jpeg_quality

It's a filter: your callback receives the value and 1 more argument, and must return the (changed) value. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_filter( 'jpeg_quality', function( $quality, $arg2 ) {
	// Change $quality here.
	return $quality;
}, 10, 2 );

Argument names come from Gutenberg's source. Other plugins may pass different values: check the call in the plugin you're targeting below.

This hook is fired by WordPress core too. Official reference on developer.wordpress.org →

33 plugins that fire jpeg_quality

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. EWWW Image Optimizer icon EWWW Image Optimizer1+ million installs apply_filters( 'jpeg_quality', 82, 'image_resize' ) classes/class-ewww-nextgen.php:153
  2. Gutenberg icon Gutenberg400,000+ installs apply_filters( 'jpeg_quality', $quality, 'image_resize' ) lib/media/class-gutenberg-rest-attachments-controller.php:1797
  3. Perfect Images: Regenerate Thumbnails, Image Sizes, WebP & AVIF icon Perfect Images: Regenerate Thumbnails, Image Sizes, WebP & AVIF60,000+ installs apply_filters( 'jpeg_quality', 75 ) classes/engine.php:50
  4. Protect Uploads icon Protect Uploads40,000+ installs apply_filters( 'jpeg_quality', 90, 'protect_uploads_watermark' ) includes/class-protect-uploads-image.php:485
  5. Gallery by BestWebSoft icon Gallery by BestWebSoft10,000+ installs apply_filters( 'jpeg_quality', $jpeg_quality, 'image_resize' ) gallery-plugin.php:3760
  6. The Paste icon The Paste9,000+ installs apply_filters( 'jpeg_quality', $options->image_quality, 'edit_image' ) include/ThePaste/Admin/Admin.php:131
  7. FV Player 8 icon FV Player 81,000+ installs apply_filters( 'jpeg_quality', $quality, 'image_resize' ) models/x-cards.php:238
  8. Sharpen Resized Images icon Sharpen Resized Images1,000+ installs apply_filters( 'jpeg_quality', 90, 'edit_image' ) ajx-sharpen-resized-images.php:58
  9. Disable Thumbnails, Threshold and Image Options icon Disable Thumbnails, Threshold and Image Options1,000+ installs apply_filters( 'jpeg_quality', 82, 'image_resize' ) disable-thumbnails-and-thresold.php:195
  10. WPWaterMark 轻水印插件 icon WPWaterMark 轻水印插件800+ installs apply_filters( 'jpeg_quality', $q ) WaterMarkHandler.php:666
  11. Seraphinite Post .DOCX Source icon Seraphinite Post .DOCX Source800+ installs apply_filters( 'jpeg_quality', $quality, 'image_resize' ) helper.php:705
  12. Watermark RELOADED icon Watermark RELOADED700+ installs apply_filters( 'jpeg_quality', 90 ) class-watermark-reloaded.php:404
  13. Portfolio by BestWebSoft icon Portfolio by BestWebSoft600+ installs apply_filters( 'jpeg_quality', $jpeg_quality, 'image_resize' ) portfolio.php:1701
  14. TheDock Media icon TheDock Media500+ installs apply_filters( 'jpeg_quality', $q, 'image_resize' ) includes/class-resolver.php:235
  15. Custom Menu icon Custom Menu400+ installs apply_filters( 'jpeg_quality', 90, 'wp_crop_image' ) class-custom-menu-admin.php:109
  16. VA Removing Exif icon VA Removing Exif300+ installs apply_filters( 'jpeg_quality', 90 ) incs/class-module-core.php:189
  17. Image Protection icon Image Protection300+ installs apply_filters( 'jpeg_quality', 92, 'image_protection_exif_strip' ) includes/class-image-protection-exif-privacy.php:1069
  18. Opti MozJpeg Guetzli WebP icon Opti MozJpeg Guetzli WebP90+ installs apply_filters( 'jpeg_quality', '75' ) class_wpmjgu_batch_revert_worker.php:20
  19. Media Features icon Media Features80+ installs apply_filters( 'jpeg_quality', 90, 'image_resize' ) media-features.php:247
  20. BuddyPress Album icon BuddyPress Album60+ installs apply_filters( 'jpeg_quality', $jpeg_quality, 'image_resize' ) includes/class.image.php:296
  21. Easy Image Optimizer icon Easy Image Optimizer60+ installs apply_filters( 'jpeg_quality', null, 'image_resize' ) classes/class-exactdn.php:292
  22. Image Focus Point icon Image Focus Point60+ installs apply_filters( 'jpeg_quality', 90, 'wp_crop_image' ) imageFocusPoint.php:279
  23. Smart Watermark icon Smart Watermark50+ installs apply_filters( 'jpeg_quality', $this->quality, 'image_resize' ) includes/class-wp-image-editor-gd.php:364
  24. Sharpen Images icon Sharpen Images20+ installs apply_filters( 'jpeg_quality', 90, 'edit_image' ) sharpen_images.php:33
  25. BuddyPics icon BuddyPics20+ installs apply_filters( 'jpeg_quality', $jpeg_quality, 'image_resize' ) includes/class.image.php:318
  26. Ninja Shop icon Ninja Shop20+ installs apply_filters( 'jpeg_quality', $jpeg_quality ) lib/classes/it-image-utility.php:177
  27. AVIF Local Support icon AVIF Local Support20+ installs apply_filters( 'jpeg_quality', $quality, 'image_resize' ) includes/Admin/RestController.php:1076
  28. WP Missing Functions Plugin icon WP Missing Functions Plugin10+ installs apply_filters( 'jpeg_quality', 90, 'edit_image' ) asset/required/functions/tab3-fun.php:135
  29. Crates Product Image Processor for WooCommerce icon Crates Product Image Processor for WooCommerce10+ installs apply_filters( 'jpeg_quality', 82, 'image_resize' ) product-image-processor.php:552
  30. Media Toolkit icon Media Toolkit10+ installs apply_filters( 'jpeg_quality', $quality, 'image_resize' ) functions.php:288
  31. WP-LatestPhotos icon WP-LatestPhotos10+ installs apply_filters( 'jpeg_quality', $jpeg_quality, 'image_resize' ) wp-latestphotos.php:317
  32. Asciify icon AsciifyFewer than 10 installs apply_filters( 'jpeg_quality', 90, 'edit_image' ) asciify.php:547
  33. ScrapeLock icon ScrapeLockFewer than 10 installs apply_filters( 'jpeg_quality', $quality, 'pncp_watermark' ) includes/class-pncp-watermark.php:1657

Need a customisation built on this hook?

Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.