Enabling Optimization of Animated GIFs

To scale animated GIFs, Adaptive Media uses an external tool called Gifsicle.

If Gifsicle isn’t installed and image/gif is included as a supported MIME type, Adaptive Media scales only one frame of the GIF, making a static GIF.

Optimizing animated GIFs using Adaptive Media requires three steps: installing Gifsicle on your local server where DXP is running, setting the PATH environment variable, and then enabling Gifsicle in DXP’s System Settings.

1. Install Gifsicle and add it to the server’s PATH environment variable.

   Note

   Gifsicle is removed from all Liferay Docker images starting with the 2025.Q2 release line. This applies to every image built from that point onward, including patch releases for earlier lines (for example, 2025.Q1.x images built after 2025.Q2).

   You can still install Gifsicle manually in your container. See Installing ImageMagick and Gifsicle Manually for details.

2. Configure Adaptive Media:

   1. Navigate to the Global Menu, select the Control Panel tab, and click System Settings → Adaptive Media.

      

   2. Under Images, check Gifsicle Enabled.

      

3. Additional Steps:

   • If ImageMagick is set to handle image/gif, GIFs may not display correctly. To prevent conflicts, select ImageMagick in the left menu and click Remove Setting () next to image/gif under Supported MIME Types to ensure Gifsicle handles optimization.

     

   • If Adaptive Media is disabled, previews and thumbnails are not displayed in Documents and Media. Ensure at least one Adaptive Media setting is enabled.

     

4. Click Save when finished.

Related Topics

• Using Adaptive Media
• Using Adapted Images in Site Content