---
title: "symbolEffect(_:options:value:)"
framework: swiftui
role: symbol
role_heading: Instance Method
path: "swiftui/view/symboleffect(_:options:value:)"
---

# symbolEffect(_:options:value:)

Returns a new view with a symbol effect added to it.

## Declaration

```swift
nonisolated func symbolEffect<T, U>(_ effect: T, options: SymbolEffectOptions = .default, value: U) -> some View where T : DiscreteSymbolEffect, T : SymbolEffect, U : Equatable

```

## Parameters

- `effect`: A symbol effect to add to the view. Existing effects added by ancestors of the view are preserved, but may be overridden by the new effect. Added effects will be applied to the doc://com.apple.SwiftUI/documentation/SwiftUI/Image views contained by the child view.
- `value`: The value to monitor for changes, the animation is triggered each time the value changes.

## Return Value

Return Value A copy of the view with a symbol effect added.

## Discussion

Discussion The following example adds a bounce effect to two symbol images, the animation will play each time counter changes: VStack {     Image(systemName: "bolt.slash.fill")     Image(systemName: "folder.fill.badge.person.crop") } .symbolEffect(.bounce, value: counter)

## See Also

### Managing symbol effects

- [symbolEffect(_:options:isActive:)](swiftui/view/symboleffect(_:options:isactive:).md)
- [symbolEffectsRemoved(_:)](swiftui/view/symboleffectsremoved(_:).md)
- [SymbolEffectTransition](swiftui/symboleffecttransition.md)