wppaste
WordPress

apply_filters( 'image_sideload_extensions', string[] $allowed_extensions, string $file )

Since
5.6.0, 5.8.0
Filters the list of allowed file extensions when sideloading an image from a URL.

Description

The default allowed extensions are:

  • jpg
  • jpeg
  • jpe
  • png
  • gif
  • webp

Compatibility

WordPress
since 5.8.0
  • 6.7.7
  • 6.8.8
  • 6.9.7
  • 7.0.4
  • 7.1.0

Present in every tracked release (6.7.7 to 7.1.0).

Parameters

$allowed_extensionsstring[]
Array of allowed file extensions.
$filestring
The URL of the image to download.

Where this hook fires · 1

  • wp-admin/includes/media.php:1056media_sideload_image()

Source code

		 * @since 5.6.0		 * @since 5.8.0 Added 'webp' to the default list of allowed file extensions.		 *		 * @param string[] $allowed_extensions Array of allowed file extensions.		 * @param string   $file               The URL of the image to download.		 */		$allowed_extensions = apply_filters( 'image_sideload_extensions', $allowed_extensions, $file );		$allowed_extensions = array_map( 'preg_quote', $allowed_extensions ); 		// Set variables for storage, fix file filename for query strings.		preg_match( '/[^\?]+\.(' . implode( '|', $allowed_extensions ) . ')\b/i', $file, $matches ); 		if ( ! $matches ) {

Changelog

Introduced in 5.6.0. Unchanged from 6.7.7 through 7.1.0.

  1. 6.7.7
  2. 6.8.8
  3. 6.9.7
  4. 7.0.4
  5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

5.8.0
Added 'webp' to the default list of allowed file extensions.from the docblock
5.6.0
Introduced.from the docblock

About this page

Parsed data
Generated from the wordpress-develop 7.1.0 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
Corrections
Something wrong on this page? Report it and it gets fixed in the next regeneration.