<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "macCatalyst: -",
    "tvOS: -",
    "visionOS: -",
    "watchOS: 4.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIFont/Weight",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:@T@UIFontWeight"
  },
  "title" : "UIFont.Weight"
}
-->

# UIFont.Weight

Constants that represent standard typeface styles.

```
struct Weight
```

## Overview

Use system-defined constants as interchangeable values for [`weight`](/documentation/UIKit/UIFontDescriptor/TraitKey/weight). Each constant corresponds to a different value that indicates the weight of a font. Use these constants to specify the weight parameter in [`systemFont(ofSize:weight:)`](/documentation/UIKit/UIFont/systemFont(ofSize:weight:)). When providing a weight that doesn’t precisely match a font face in the family, the system locates a face that most closely matches the request.

> Note:
> Font ``doc://com.apple.uikit/documentation/UIKit/UIFont/familyNames`` don’t include all system-defined font constants.

## Topics

### Using system-defined font weights

[`ultraLight`](/documentation/UIKit/UIFont/Weight/ultraLight)

The ultra-light font weight.

[`thin`](/documentation/UIKit/UIFont/Weight/thin)

The thin font weight.

[`light`](/documentation/UIKit/UIFont/Weight/light)

The light font weight.

[`regular`](/documentation/UIKit/UIFont/Weight/regular)

The regular font weight.

[`medium`](/documentation/UIKit/UIFont/Weight/medium)

The medium font weight.

[`semibold`](/documentation/UIKit/UIFont/Weight/semibold)

The semibold font weight.

[`bold`](/documentation/UIKit/UIFont/Weight/bold)

The bold font weight.

[`heavy`](/documentation/UIKit/UIFont/Weight/heavy)

The heavy font weight.

[`black`](/documentation/UIKit/UIFont/Weight/black)

The black font weight.

### Balancing the appearance of symbols and text

[`symbolWeight()`](/documentation/UIKit/UIFont/Weight/symbolWeight())

Provides the corresponding symbol weight for this font weight.

### Initializers

[`init(_:)`](/documentation/UIKit/UIFont/Weight/init(_:))

Creates a font weight.

[`init(rawValue:)`](/documentation/UIKit/UIFont/Weight/init(rawValue:))

Creates a font weight with the specified raw value.


---

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)