<!--
{
  "availability" : [
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "WatchKit",
  "identifier" : "/documentation/WatchKit/WKInterfaceImage/setImage(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "WatchKit"
    ],
    "preciseIdentifier" : "c:objc(cs)WKInterfaceImage(im)setImage:"
  },
  "title" : "setImage(_:)"
}
-->

# setImage(_:)

Sets the displayed image using the specified image object.

```
func setImage(_ image: UIImage?)
```

## Parameters

`image`

The image to be displayed. Specifying `nil` removes the existing image, causing the watch interface to display nothing in the space previously occupied by the image. You may specify a template image or an animated image sequence for this parameter.  For information on how to specify an animated image, see [`Animating a Series of Images`](/documentation/WatchKit/WKInterfaceImage#Animating-a-Series-of-Images).

## Discussion

This method changes the image being displayed. Use this method to assign either a static image or an animated image that you created using the <doc://com.apple.documentation/documentation/UIKit/UIImage/animatedImage(with:duration:)> method.

When setting images, always try to use images that are sized to fit the available space. Images are rendered according to the mode and size attributes you set for the image interface object.

## See Also

  [App Programming Guide for watchOS](https://developer.apple.com/library/archive/documentation/General/Conceptual/WatchKitProgrammingGuide/index.html#//apple_ref/doc/uid/TP40014969)


---

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)