---
title: "addSymbolEffect(_:options:animated:completion:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uiimageview/addsymboleffect(_:options:animated:completion:)-18jqj"
---

# addSymbolEffect(_:options:animated:completion:)

Adds a discrete symbol effect to the image view with the specified options and animation.

## Declaration

```swift
@MainActor @preconcurrency func addSymbolEffect(_ effect: some IndefiniteSymbolEffect & SymbolEffect, options: SymbolEffectOptions = .default, animated: Bool = true, completion: UISymbolEffectCompletion? = nil)
```

## Parameters

- `effect`: The symbol effect to add.
- `options`: The options for the symbol effect.
- `animated`: A Boolean value that indicates whether to animate the addition of a scale, appear, or disappear effect.
- `completion`: A completion handler the system calls after the effect’s addition is complete.

## See Also

### Configuring symbol effects

- [addSymbolEffect(_:options:animated:completion:)](uikit/uiimageview/addsymboleffect(_:options:animated:completion:)-2ixnm.md)
- [addSymbolEffect(_:options:animated:completion:)](uikit/uiimageview/addsymboleffect(_:options:animated:completion:)-896qd.md)
- [setSymbolImage(_:contentTransition:options:completion:)](uikit/uiimageview/setsymbolimage(_:contenttransition:options:completion:).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)