---
title: NSLigatureAttributeName
framework: uikit
role: symbol
role_heading: Global Variable
path: uikit/nsligatureattributename
---

# NSLigatureAttributeName

The ligature of the text.

## Declaration

```occ
extern NSAttributedStringKey const NSLigatureAttributeName;
```

## Overview

Overview The value of this attribute is an NSNumber object containing an integer. Ligatures cause specific character combinations to be rendered using a single custom glyph that corresponds to those characters. The value 0 indicates no ligatures. The value 1 indicates the use of the default ligatures. The value 2 indicates the use of all ligatures. The default value for this attribute is 1. (Value 2 is unsupported on iOS.)

## See Also

### Getting rendering attribute keys

- [NSBackgroundColorAttributeName](uikit/nsbackgroundcolorattributename.md)
- [NSBaselineOffsetAttributeName](uikit/nsbaselineoffsetattributename.md)
- [NSFontAttributeName](uikit/nsfontattributename.md)
- [NSForegroundColorAttributeName](uikit/nsforegroundcolorattributename.md)
- [NSKernAttributeName](uikit/nskernattributename.md)
- [NSParagraphStyleAttributeName](uikit/nsparagraphstyleattributename.md)
- [NSStrikethroughColorAttributeName](uikit/nsstrikethroughcolorattributename.md)
- [NSStrikethroughStyleAttributeName](uikit/nsstrikethroughstyleattributename.md)
- [NSStrokeColorAttributeName](uikit/nsstrokecolorattributename.md)
- [NSStrokeWidthAttributeName](uikit/nsstrokewidthattributename.md)
- [NSTrackingAttributeName](uikit/nstrackingattributename.md)
- [NSUnderlineColorAttributeName](uikit/nsunderlinecolorattributename.md)
- [NSUnderlineStyleAttributeName](uikit/nsunderlinestyleattributename.md)
- [NSWritingDirectionAttributeName](uikit/nswritingdirectionattributename.md)