There’s a common issue in WordPress where animated GIFs don’t seem to work properly.

Usually the image shows up—but it’s just a static frame, rather than a properly looping GIF.

Sound familiar?

If you’re experiencing this problem, it’s likely because WordPress is cropping the GIF to one of its predetermined image sizes (e.g. thumbnail, medium, or large).

This works fine for static images (JPEG, PNG, etc.), but when WordPress crops an animated GIF, it just grabs a single frame from the image, killing the animation.

The Solution

The solution is simple: when you add a GIF to a post or page, be sure to include the full size version of the image.

Here’s what that looks like in the block editor:

Select your image block and make sure the image size is set to “Full Size.”

Once you’ve done this, you should find that your GIF starts animating as intended.

If you have any questions about using animated GIFs in WordPress, feel free to leave them in the comments below!