<!--
{
  "documentType" : "article",
  "framework" : "Accessibility",
  "identifier" : "/documentation/Accessibility/animated-images",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Animated images"
}
-->

# Animated images

Pause animations in animated images in your app when people turn off the Animated
Images setting.

## Discussion

People use the Animated Images setting to control whether to play animated images
like GIFs on the web and in apps. By default, the setting is on, which allows animated
images to play automatically. A person can turn off the setting to indicate that
they want to pause animated images on their device.

In your app, handle changes to the Animated Images setting to create an enjoyable
experience for people who choose to pause animated images. Register for the notification
[`animatedImagesEnabledDidChangeNotification`](/documentation/Accessibility/AccessibilitySettings/animatedImagesEnabledDidChangeNotification) to respond to changes
in this setting:

```swift
import Accessibility

NotificationCenter.default.addObserver(self,
    selector: #selector(animatedImagesChanged),
    name: NSNotification.Name.animatedImagesEnabledDidChangeNotification,
    object: nil)
```

When the Animated Images setting changes, perform changes to your UI to pause animated
images:

```swift
@objc 
func animatedImagesChanged(_ notification: Notification) {
    if AccessibilitySettings.animatedImagesEnabled {
        // The setting is on. Animate images.
    } else {
        // The setting is off. Pause animations in animated images.
    }
}
```

Check the value of the Animated Images setting at any time by using [`animatedImagesEnabled`](/documentation/Accessibility/AccessibilitySettings/animatedImagesEnabled).

## Topics

### Animated images

[`animatedImagesEnabled`](/documentation/Accessibility/AccessibilitySettings/animatedImagesEnabled)

A Boolean value that indicates whether the system setting for playing animated images is on.

[`animatedImagesEnabledDidChangeNotification`](/documentation/Accessibility/AccessibilitySettings/animatedImagesEnabledDidChangeNotification)

A notification that posts when the system setting for playing animated images changes.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)