Changeset 64490

Timestamp:

10/18/2026 10:36:44 PM (30 hours ago)

Author:

adamsilverstein

Message:

Media: Generate animated image sub-sizes by default.

Fix an issue where sub-sizes of animated image uploads were static first-frame images, as GD and Imagick flatten animated images when resizing. When client-side media processing is active, generated images now retain animations.

Add a wp_generate_animated_image_subsizes filter (boolean, default true) so the client pipeline can keep or drop the animation in sub-sizes. The client-side consumption ships via the Gutenberg package updates in ​https://github.com/WordPress/gutenberg/pull/80385.

Fixes #65656, #28474.

Location:

trunk

Files:

• src/wp-admin/edit-form-blocks.php (modified) (1 diff)
• src/wp-admin/site-editor.php (modified) (1 diff)
• src/wp-includes/rest-api/class-wp-rest-server.php (modified) (1 diff)
• tests/phpunit/tests/rest-api/rest-server.php (modified) (5 diffs)
• tests/qunit/fixtures/wp-api-generated.js (modified) (1 diff)

trunk/src/wp-admin/edit-form-blocks.php

@@ -95 +95 @@
                 array(
                         'description',
+                        'generate_animated_image_subsizes',
                         'gmt_offset',
                         'home',

trunk/src/wp-admin/site-editor.php

@@ -221 +221 @@
                 array(
                         'description',
+                        'generate_animated_image_subsizes',
                         'gmt_offset',
                         'home',

trunk/src/wp-includes/rest-api/class-wp-rest-server.php

@@ -1464 +1464 @@
                         /** This filter is documented in wp-includes/class-wp-image-editor-imagick.php */
                         $available['image_max_bit_depth'] = (int) apply_filters( 'image_max_bit_depth', 16, 16 );
+
+                        /**
+                         * Filters whether client-side media processing preserves animation in image sub-sizes.
+                         *
+                         * By default, sub-sizes of animated GIF and WebP images retain animation,
+                         * including cropped sizes. Return false to generate static sub-sizes using
+                         * only the first frame, reducing processing time in the browser.
+                         *
+                         * This setting applies only to client-side media processing. Server-side
+                         * processing continues to generate static sub-sizes.
+                         *
+                         * @since 7.2.0
+                         *
+                         * @param bool $generate_animated_image_subsizes Whether to preserve animation in image sub-sizes.
+                         *                                               Default true.
+                         */
+                        $available['generate_animated_image_subsizes'] = (bool) apply_filters( 'wp_generate_animated_image_subsizes', true );
                 }
 

trunk/tests/phpunit/tests/rest-api/rest-server.php

@@ -1215 +1215 @@
         /**
          * @ticket 64804
+         * @ticket 65656
          *
          * @covers WP_REST_Server::get_index
@@ -1235 +1236 @@
                 $this->assertArrayHasKey( 'image_max_bit_depth', $data );
                 $this->assertSame( 16, $data['image_max_bit_depth'] );
+                $this->assertArrayHasKey( 'generate_animated_image_subsizes', $data );
+                $this->assertTrue( $data['generate_animated_image_subsizes'] );
         }
 
         /**
          * @ticket 64804
+         * @ticket 65656
          *
          * @covers WP_REST_Server::get_index
@@ -1255 +1259 @@
                 $this->assertArrayNotHasKey( 'image_strip_meta', $data );
                 $this->assertArrayNotHasKey( 'image_max_bit_depth', $data );
+                $this->assertArrayNotHasKey( 'generate_animated_image_subsizes', $data );
         }
 
         /**
          * @ticket 64804
+         * @ticket 65656
          *
          * @covers WP_REST_Server::get_index
@@ -1271 +1277 @@
                         static fn ( int $max_depth ) => min( 8, $max_depth )
                 );
+                add_filter( 'wp_generate_animated_image_subsizes', '__return_false' );
 
                 $server  = new WP_REST_Server();
@@ -1279 +1286 @@
                 $this->assertFalse( $data['image_strip_meta'] );
                 $this->assertSame( 8, $data['image_max_bit_depth'] );
+                $this->assertFalse( $data['generate_animated_image_subsizes'] );
         }
 

trunk/tests/qunit/fixtures/wp-api-generated.js

@@ -13079 +13079 @@
     "image_strip_meta": true,
     "image_max_bit_depth": 16,
+    "generate_animated_image_subsizes": true,
     "site_logo": 0,
     "site_icon": 0,