---
title: UIImage.SymbolScale
framework: uikit
role: symbol
role_heading: Enumeration
path: uikit/uiimage/symbolscale
---

# UIImage.SymbolScale

Constants that indicate which scale variant of a symbol image to use.

## Declaration

```swift
enum SymbolScale
```

## Mentioned in

Configuring and displaying symbol images in your UI

## Overview

Overview The definition of a symbol image includes multiple scale and weight variants. Scale variants offer a way to define the size of the image relative to layout guides in the symbol image’s definition file. The system chooses the appropriate size variant based on the available space and configuration options.

## Topics

### Symbol image scales

- [UIImage.SymbolScale.default](uikit/uiimage/symbolscale/default.md)
- [UIImage.SymbolScale.unspecified](uikit/uiimage/symbolscale/unspecified.md)
- [UIImage.SymbolScale.small](uikit/uiimage/symbolscale/small.md)
- [UIImage.SymbolScale.medium](uikit/uiimage/symbolscale/medium.md)
- [UIImage.SymbolScale.large](uikit/uiimage/symbolscale/large.md)

### Initializers

- [init(rawValue:)](uikit/uiimage/symbolscale/init(rawvalue:).md)

## Relationships

### Conforms To

- [BitwiseCopyable](swift/bitwisecopyable.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [RawRepresentable](swift/rawrepresentable.md)
- [Sendable](swift/sendable.md)
- [SendableMetatype](swift/sendablemetatype.md)

## See Also

### Creating a symbol configuration

- [init(pointSize:)](uikit/uiimage/symbolconfiguration-swift.class/init(pointsize:).md)
- [init(pointSize:weight:)](uikit/uiimage/symbolconfiguration-swift.class/init(pointsize:weight:).md)
- [init(pointSize:weight:scale:)](uikit/uiimage/symbolconfiguration-swift.class/init(pointsize:weight:scale:).md)
- [init(scale:)](uikit/uiimage/symbolconfiguration-swift.class/init(scale:).md)
- [init(textStyle:)](uikit/uiimage/symbolconfiguration-swift.class/init(textstyle:).md)
- [init(textStyle:scale:)](uikit/uiimage/symbolconfiguration-swift.class/init(textstyle:scale:).md)
- [init(weight:)](uikit/uiimage/symbolconfiguration-swift.class/init(weight:).md)
- [init(font:)](uikit/uiimage/symbolconfiguration-swift.class/init(font:).md)
- [init(font:scale:)](uikit/uiimage/symbolconfiguration-swift.class/init(font:scale:).md)
- [UIImage.SymbolWeight](uikit/uiimage/symbolweight.md)
- [UIImage.SymbolColorRenderingMode](uikit/uiimage/symbolcolorrenderingmode.md)
- [UIImage.SymbolVariableValueMode](uikit/uiimage/symbolvariablevaluemode.md)