---
title: ReplaceSymbolEffect
framework: symbols
role: symbol
role_heading: Structure
path: symbols/replacesymboleffect
---

# ReplaceSymbolEffect

A type that replaces the layers of one symbol-based image with those of another.

## Declaration

```swift
struct ReplaceSymbolEffect
```

## Overview

Overview A replace transition animates the change from one symbol image to another. You choose from one of the predefined scaling animations: Down-Up, Off-Up, and Up-Up.

## Topics

### Accessing symbol effects

- [downUp](symbols/replacesymboleffect/downup-swift.property.md)
- [offUp](symbols/replacesymboleffect/offup-swift.property.md)
- [upUp](symbols/replacesymboleffect/upup-swift.property.md)

### Determining effect scope

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

### Accessing the configuration

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

### Structures

- [ReplaceSymbolEffect.MagicReplace](symbols/replacesymboleffect/magicreplace.md)

### Instance Methods

- [magic(fallback:)](symbols/replacesymboleffect/magic(fallback:).md)

### Type Properties

- [downUp](symbols/replacesymboleffect/downup-swift.type.property.md)
- [offUp](symbols/replacesymboleffect/offup-swift.type.property.md)
- [upUp](symbols/replacesymboleffect/upup-swift.type.property.md)

## Relationships

### Conforms To

- [ContentTransitionSymbolEffect](symbols/contenttransitionsymboleffect.md)
- [Copyable](swift/copyable.md)
- [Equatable](swift/equatable.md)
- [Escapable](swift/escapable.md)
- [Hashable](swift/hashable.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)
- [PulseSymbolEffect](symbols/pulsesymboleffect.md)
- [ScaleSymbolEffect](symbols/scalesymboleffect.md)
- [VariableColorSymbolEffect](symbols/variablecolorsymboleffect.md)
- [BreatheSymbolEffect](symbols/breathesymboleffect.md)
- [RotateSymbolEffect](symbols/rotatesymboleffect.md)
- [WiggleSymbolEffect](symbols/wigglesymboleffect.md)