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

# NSLigatureAttributeName

The ligature of the text.

## Declaration

```occ
extern NSAttributedStringKey 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](appkit/nsbackgroundcolorattributename.md)
- [NSBaselineOffsetAttributeName](appkit/nsbaselineoffsetattributename.md)
- [NSFontAttributeName](appkit/nsfontattributename.md)
- [NSForegroundColorAttributeName](appkit/nsforegroundcolorattributename.md)
- [NSGlyphInfoAttributeName](appkit/nsglyphinfoattributename.md)
- [NSKernAttributeName](appkit/nskernattributename.md)
- [NSParagraphStyleAttributeName](appkit/nsparagraphstyleattributename.md)
- [NSStrikethroughColorAttributeName](appkit/nsstrikethroughcolorattributename.md)
- [NSStrikethroughStyleAttributeName](appkit/nsstrikethroughstyleattributename.md)
- [NSStrokeColorAttributeName](appkit/nsstrokecolorattributename.md)
- [NSStrokeWidthAttributeName](appkit/nsstrokewidthattributename.md)
- [NSSuperscriptAttributeName](appkit/nssuperscriptattributename.md)
- [NSTrackingAttributeName](appkit/nstrackingattributename.md)
- [NSUnderlineColorAttributeName](appkit/nsunderlinecolorattributename.md)
- [NSUnderlineStyleAttributeName](appkit/nsunderlinestyleattributename.md)