wp_handle_sideload_prefilter filter-hookWP 2.9.0

Filters the data for a file before it is uploaded to WordPress.

This is one of the variants of the dynamic hook (action)_prefilter


add_filter( 'wp_handle_sideload_prefilter', 'wp_kama_handle_sideload_prefilter' );

 * Function for `wp_handle_sideload_prefilter` filter-hook.
 * @param array $file Reference to a single element from `$_FILES`.
 * @return array
function wp_kama_handle_sideload_prefilter( $file ){

	// filter...
	return $file;

Reference to a single element from $_FILES.

  • name(string)
    The original name of the file on the client machine.

  • type(string)
    The mime type of the file, if the browser provided this information.

  • tmp_name(string)
    The temporary filename of the file in which the uploaded file was stored on the server.

  • size(int)
    The size, in bytes, of the uploaded file.

  • error(int)
    The error code associated with this file upload.


Since 2.9.0 Introduced.
Since 2.9.0 as wp_handle_upload_prefilter.
Since 4.0.0 Converted to a dynamic hook with $action.

Where the hook is called

wp-admin/includes/file.php 833
$file = apply_filters( "{$action}_prefilter", $file );

Where the hook is used in WordPress

Usage not found.