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

# setSymbolImage(_:contentTransition:options:)

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

## Declaration

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

## 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.

## See Also

### Configuring symbol effects

- [isSymbolAnimationEnabled](uikit/uibarbuttonitem/issymbolanimationenabled.md)
- [addSymbolEffect(_:options:animated:)](uikit/uibarbuttonitem/addsymboleffect(_:options:animated:)-3iew0.md)
- [addSymbolEffect(_:options:animated:)](uikit/uibarbuttonitem/addsymboleffect(_:options:animated:)-6jx3e.md)
- [addSymbolEffect(_:options:animated:)](uikit/uibarbuttonitem/addsymboleffect(_:options:animated:)-9dytr.md)
- [removeSymbolEffect(ofType:options:animated:)](uikit/uibarbuttonitem/removesymboleffect(oftype:options:animated:)-214pl.md)
- [removeSymbolEffect(ofType:options:animated:)](uikit/uibarbuttonitem/removesymboleffect(oftype:options:animated:)-7m567.md)
- [removeSymbolEffect(ofType:options:animated:)](uikit/uibarbuttonitem/removesymboleffect(oftype:options:animated:)-8zc4d.md)
- [removeAllSymbolEffects(options:animated:)](uikit/uibarbuttonitem/removeallsymboleffects(options:animated:).md)