A BrowserSetting object that can be used to change the way the browser handles animated images, such as GIFs.

The underlying value is a string that can take one of three values:

  • "normal": the default. Play animated images as normal.
  • "none": don't animate images at all.
  • "once": play the animation once.

Browser compatibility

Update compatibility data on GitHub
ChromeEdgeFirefoxOperaSafariFirefox for Android
imageAnimationBehaviorChrome No support NoEdge No support NoFirefox Full support 57Opera No support NoSafari No support NoFirefox Android Full support 57


Full support  
Full support
No support  
No support


Disable animated images:

  browser.browserSettings.imageAnimationBehavior.set({value: "none"});