---
title: PulseSymbolEffect
framework: symbols
role: symbol
role_heading: Structure
path: symbols/pulsesymboleffect
---

# PulseSymbolEffect

A type that fades the opacity of some or all layers in a symbol-based image.

## Declaration

```swift
struct PulseSymbolEffect
```

## Overview

Overview A pulse animation applies an opacity ramp to the layers in a symbol. You can choose to animate only layers marked as “always-pulses” or all layers simultaneously. Participating layers reduce their opacity to a minimum value before returning to fully opaque. important: Because SwiftUI is a state-driven framework, you pass a value parameter when adding discrete effects, like bounce. You trigger the animation by changing the value parameter. Because AppKit and UIKit are event-driven frameworks, discrete effects animate automatically when added to an image view. // Add an effect in SwiftUI. @State private var value1 = 0 @State private var value2 = 0 var body: some View {     HStack {         Image(systemName: "person.text.rectangle")             // Pulse only layers marked as "always-pulse."             .symbolEffect(.pulse, value: value1)             .onTapGesture {                 value1 += 1             }         Image(systemName: "person.text.rectangle")             // Pulse all layers three times simultaneously.             .symbolEffect(.pulse.wholeSymbol, options: .repeat(3), value: value2)             .onTapGesture {                 value2 += 1             }     } } // Add an effect in AppKit and UIKit. // Pulse only layers marked as "always-pulse." imageView1.addSymbolEffect(.pulse.byLayer, options: .nonRepeating)      // Pulse all layers three times simultaneously. imageView2.addSymbolEffect(.pulse.wholeSymbol, options: .repeat(3))

## Topics

### Determining effect scope

- [byLayer](symbols/pulsesymboleffect/bylayer.md)
- [wholeSymbol](symbols/pulsesymboleffect/wholesymbol.md)

### Accessing the configuration

- [configuration](symbols/pulsesymboleffect/configuration.md)

## Relationships

### Conforms To

- [Copyable](swift/copyable.md)
- [DiscreteSymbolEffect](symbols/discretesymboleffect.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [Hashable](swift/hashable.md)
- [IndefiniteSymbolEffect](symbols/indefinitesymboleffect.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)
- [SymbolEffect](symbols/symboleffect.md)

## See Also

### Symbol effect types

- [AppearSymbolEffect](symbols/appearsymboleffect.md)
- [AutomaticSymbolEffect](symbols/automaticsymboleffect.md)
- [BounceSymbolEffect](symbols/bouncesymboleffect.md)
- [DisappearSymbolEffect](symbols/disappearsymboleffect.md)
- [ReplaceSymbolEffect](symbols/replacesymboleffect.md)
- [ScaleSymbolEffect](symbols/scalesymboleffect.md)
- [VariableColorSymbolEffect](symbols/variablecolorsymboleffect.md)
- [BreatheSymbolEffect](symbols/breathesymboleffect.md)
- [RotateSymbolEffect](symbols/rotatesymboleffect.md)
- [WiggleSymbolEffect](symbols/wigglesymboleffect.md)