---
title: "setPosterImage(_:)"
framework: watchkit
role: symbol
role_heading: Instance Method
path: "watchkit/wkinterfaceinlinemovie/setposterimage(_:)"
---

# setPosterImage(_:)

Sets the poster image to display for the movie.

## Declaration

```swift
func setPosterImage(_ posterImage: WKImage?)
```

## Parameters

- `posterImage`: 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.

## Discussion

Discussion This method changes the poster image that is displayed for the movie.

## See Also

### Setting Movie Properties

- [setAutoplays(_:)](watchkit/wkinterfaceinlinemovie/setautoplays(_:).md)
- [setLoops(_:)](watchkit/wkinterfaceinlinemovie/setloops(_:).md)
- [setMovieURL(_:)](watchkit/wkinterfaceinlinemovie/setmovieurl(_:).md)
- [setVideoGravity(_:)](watchkit/wkinterfaceinlinemovie/setvideogravity(_:).md)