---
title: "addSymbolEffect(_:options:animated:)"
framework: appkit
role: symbol
role_heading: Instance Method
path: "appkit/nsimageview/addsymboleffect(_:options:animated:)-66ckm"
---

# addSymbolEffect(_:options:animated:)

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

## Declaration

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

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

## See Also

### Configuring symbol effects

- [addSymbolEffect(_:options:animated:)](appkit/nsimageview/addsymboleffect(_:options:animated:)-4kete.md)
- [addSymbolEffect(_:options:animated:)](appkit/nsimageview/addsymboleffect(_:options:animated:)-4p7p7.md)
- [setSymbolImage(_:contentTransition:options:)](appkit/nsimageview/setsymbolimage(_:contenttransition:options:).md)
- [removeSymbolEffect(ofType:options:animated:)](appkit/nsimageview/removesymboleffect(oftype:options:animated:)-8bszd.md)
- [removeSymbolEffect(ofType:options:animated:)](appkit/nsimageview/removesymboleffect(oftype:options:animated:)-4c6vq.md)
- [removeSymbolEffect(ofType:options:animated:)](appkit/nsimageview/removesymboleffect(oftype:options:animated:)-8tk6g.md)
- [removeAllSymbolEffects(options:animated:)](appkit/nsimageview/removeallsymboleffects(options:animated:).md)