---
title: "setSymbolImage(_:contentTransition:options:completion:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uiimageview/setsymbolimage(_:contenttransition:options:completion:)"
---

# setSymbolImage(_:contentTransition:options:completion:)

Sets a symbol image using the specified content-transition effect, options, and completion handler.

## Declaration

```swift
@MainActor @preconcurrency func setSymbolImage(_ image: UIImage, contentTransition: some ContentTransitionSymbolEffect & SymbolEffect, options: SymbolEffectOptions = .default, completion: UISymbolEffectCompletion? = nil)
```

## Parameters

- `image`: The symbol image to set.
- `contentTransition`: The content transition to use when setting the symbol image.
- `options`: The options to use when setting the symbol image.
- `completion`: A completion handler the system calls after setting the symbol image.

## See Also

### Configuring symbol effects

- [addSymbolEffect(_:options:animated:completion:)](uikit/uiimageview/addsymboleffect(_:options:animated:completion:)-18jqj.md)
- [addSymbolEffect(_:options:animated:completion:)](uikit/uiimageview/addsymboleffect(_:options:animated:completion:)-2ixnm.md)
- [addSymbolEffect(_:options:animated:completion:)](uikit/uiimageview/addsymboleffect(_:options:animated:completion:)-896qd.md)
- [removeSymbolEffect(ofType:options:animated:completion:)](uikit/uiimageview/removesymboleffect(oftype:options:animated:completion:)-218lh.md)
- [removeSymbolEffect(ofType:options:animated:completion:)](uikit/uiimageview/removesymboleffect(oftype:options:animated:completion:)-31zec.md)
- [removeSymbolEffect(ofType:options:animated:completion:)](uikit/uiimageview/removesymboleffect(oftype:options:animated:completion:)-2boi2.md)
- [removeAllSymbolEffects(options:animated:)](uikit/uiimageview/removeallsymboleffects(options:animated:).md)
- [UISymbolEffectCompletion](uikit/uisymboleffectcompletion-7qt7g.md)
- [UISymbolEffectCompletionContext](uikit/uisymboleffectcompletioncontext-swift.struct.md)