<!--
{
  "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/SymbolWeight",
  "metadataVersion" : "0.1.0",
  "role" : "Enumeration",
  "symbol" : {
    "kind" : "Enumeration",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:@E@UIImageSymbolWeight"
  },
  "title" : "UIImage.SymbolWeight"
}
-->

# UIImage.SymbolWeight

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

```
enum SymbolWeight
```

## Overview

The definition of a symbol image includes multiple scale and weight variants. The weight variants offer a way to progressively thicken some or all of the image’s lines. Weights do not correspond to a specific line thickness.

## Topics

### Symbol image weights

[`case unspecified`](/documentation/UIKit/UIImage/SymbolWeight/unspecified)

An unspecified symbol image weight.

[`case ultraLight`](/documentation/UIKit/UIImage/SymbolWeight/ultraLight)

An ultralight weight.

[`case thin`](/documentation/UIKit/UIImage/SymbolWeight/thin)

A thin weight

[`case light`](/documentation/UIKit/UIImage/SymbolWeight/light)

A light weight.

[`case regular`](/documentation/UIKit/UIImage/SymbolWeight/regular)

A regular weight.

[`case medium`](/documentation/UIKit/UIImage/SymbolWeight/medium)

A medium weight.

[`case semibold`](/documentation/UIKit/UIImage/SymbolWeight/semibold)

A semibold weight.

[`case bold`](/documentation/UIKit/UIImage/SymbolWeight/bold)

A bold weight.

[`case heavy`](/documentation/UIKit/UIImage/SymbolWeight/heavy)

A heavy weight.

[`case black`](/documentation/UIKit/UIImage/SymbolWeight/black)

An ultra-heavy weight.

### Getting the font weight

[`func fontWeight() -> UIFont.Weight`](/documentation/UIKit/UIImage/SymbolWeight/fontWeight())

The font weight for the specified symbol weight.

### Initializers

[`init?(rawValue: Int)`](/documentation/UIKit/UIImage/SymbolWeight/init(rawValue:))

## Relationships

### Conforms To

[`RawRepresentable`](/documentation/Swift/RawRepresentable)

[`Sendable`](/documentation/Swift/Sendable)

[`Equatable`](/documentation/Swift/Equatable)

[`BitwiseCopyable`](/documentation/Swift/BitwiseCopyable)

[`Hashable`](/documentation/Swift/Hashable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

---

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)