WordPress filter hook

acf/validate_is_image_attachment/error_message

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

“Filters the error message used when an attachment is not a valid image.”

How to use acf/validate_is_image_attachment/error_message

It's a filter: your callback receives the value and 4 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/validate_is_image_attachment/error_message', function( $_, $field, $context, $file, $attachment ) {
	// Change $_ here.
	return $_;
}, 10, 5 );

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.

2 plugins that fire acf/validate_is_image_attachment/error_message

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/validate_is_image_attachment/error_message', __( 'File must be a valid image.', 'acf' ), $field, $context, $file, $attachment ) includes/api/api-helpers.php:4168
  2. Secure Custom Fields icon Secure Custom Fields100,000+ installs apply_filters( 'acf/validate_is_image_attachment/error_message', __( 'File must be a valid image.', 'secure-custom-fields' ), $field, $context, $file, $attachment ) includes/api/api-helpers.php:4463

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.