WordPress filter hook

acf/upload_prefilter

Fired by 32 WordPress plugins, running on 2.1M+ sites between them.

How to use acf/upload_prefilter

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

functions.php
add_filter( 'acf/upload_prefilter', function( $errors, $file, $field ) {
	// Change $errors here.
	return $errors;
}, 10, 3 );

Argument names come from Advanced Custom Fields (ACF®)'s source. Other plugins may pass different values: check the call in the plugin you're targeting below.

32 plugins that fire acf/upload_prefilter

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

  1. Advanced Custom Fields (ACF®) icon Advanced Custom Fields (ACF®)2+ million installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/media.php:122
  2. Secure Custom Fields icon Secure Custom Fields100,000+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/media.php:111
  3. Mapster WP Maps icon Mapster WP Maps3,000+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:122
  4. WPScreens icon WPScreens300+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:107
  5. MapifyLite (by MapifyPro) icon MapifyLite (by MapifyPro)200+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) lib/advanced-custom-fields/includes/media.php:113
  6. WP Related Posts and Products (WRI) icon WP Related Posts and Products (WRI)100+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) advanced-custom-fields/includes/media.php:106
  7. Flexblocks icon Flexblocks80+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) inc/acf/includes/media.php:113
  8. OneDS Start Package icon OneDS Start Package40+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:113
  9. Social Influencer Links icon Social Influencer Links20+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) lib/acf/includes/media.php:116
  10. Tuxedo Importer icon Tuxedo Importer20+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:113
  11. Accessibility Statement icon Accessibility Statement20+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:113
  12. FloristPress for Woo icon FloristPress for Woo10+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) lib/acf/includes/media.php:113
  13. Rexpansive Builder icon Rexpansive Builder10+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) admin/lib/acf/advanced-custom-fields/includes/media.php:113
  14. Schedule Tweets icon Schedule Tweets10+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) assets/plugins/acf/includes/media.php:106
  15. Megabits Control Gastos icon Megabits Control Gastos10+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:113
  16. WoWpi Guild icon WoWpi Guild10+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:116
  17. Proshots For WooCommerce icon Proshots For WooCommerce10+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:116
  18. Important Dates Dashboard Widget icon Important Dates Dashboard Widget10+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:113
  19. Coronavirus (COVID-19) Live Update Popup icon Coronavirus (COVID-19) Live Update Popup10+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:106
  20. Realty Pack Core icon Realty Pack Core10+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) app/acf/includes/media.php:106
  21. Mufasa 🦁 Slider icon Mufasa 🦁 Slider10+ installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:116
  22. Simple KMDG Resource Center icon Simple KMDG Resource CenterFewer than 10 installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/advanced-custom-fields/includes/media.php:116
  23. Admin Notes WP icon Admin Notes WPFewer than 10 installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/advanced-custom-fields/includes/media.php:116
  24. Contact Form 7 Analytics icon Contact Form 7 AnalyticsFewer than 10 installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) acf/core/media.php:106
  25. Ninety in Ninety icon Ninety in NinetyFewer than 10 installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) inc/acf/includes/media.php:106
  26. Admin User Control icon Admin User ControlFewer than 10 installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:106
  27. Work Time Allocator icon Work Time AllocatorFewer than 10 installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) lib/advanced-custom-fields/includes/media.php:116
  28. House Ads icon House AdsFewer than 10 installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) lib/acf/includes/media.php:106
  29. NavThemes Gutenberg Blocks icon NavThemes Gutenberg BlocksFewer than 10 installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) admin/includes/media.php:106
  30. NavThemes Employee Ratings icon NavThemes Employee RatingsFewer than 10 installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) admin/includes/media.php:106
  31. Dashboard Feeds Dashboard Widget icon Dashboard Feeds Dashboard WidgetFewer than 10 installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:113
  32. Repeat Events icon Repeat EventsFewer than 10 installs apply_filters( 'acf/upload_prefilter', $errors, $file, $field ) includes/acf/includes/media.php:116

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.