1. Mozilla
  2. Add-ons
  3. Browser extensions
  4. JavaScript APIs
  5. browserSettings
  6. browserSettings.imageAnimationBehavior

browserSettings.imageAnimationBehavior

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.

Examples

Disable animated images:

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

Browser compatibility

Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
imageAnimationBehavior
Chrome – No support
Chrome
footnote No support
Edge – No support
Edge
footnote No support
Firefox – Full support
Firefox 57 (Release date: 2017-11-14)
footnote Full support
Opera – No support
Opera
footnote No support
Safari – No support
Safari
footnote No support
Firefox for Android – Full support
Firefox for Android 57 (Release date: 2017-11-28)
footnote Full support
Safari on iOS – No support
Safari on iOS
footnote No support

Tip: you can click/tap on a cell for more information.

Full support
No support

This page was last modified on by MDN contributors.

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.