<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "tvOS: 13.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 6.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIImage/SymbolScale",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:@E@UIImageSymbolScale"
  },
  "title" : "UIImage.SymbolScale"
}
-->

# UIImage.SymbolScale

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

```
enum SymbolScale
```

## 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`](/documentation/UIKit/UIImage/SymbolScale/default)

The default scale variant that matches the system usage.

[`UIImage.SymbolScale.unspecified`](/documentation/UIKit/UIImage/SymbolScale/unspecified)

An unspecified scale.

[`UIImage.SymbolScale.small`](/documentation/UIKit/UIImage/SymbolScale/small)

The small variant of the symbol image.

[`UIImage.SymbolScale.medium`](/documentation/UIKit/UIImage/SymbolScale/medium)

The medium variant of the symbol image

[`UIImage.SymbolScale.large`](/documentation/UIKit/UIImage/SymbolScale/large)

The large variant of the symbol image.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)