<!--
{
  "availability" : [
    "macOS: 10.7.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSMutableFontCollection",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:objc(cs)NSMutableFontCollection"
  },
  "title" : "NSMutableFontCollection"
}
-->

# NSMutableFontCollection

A mutable collection of font descriptors taken together as a single object.

```
class NSMutableFontCollection
```

## Overview

You can use this class to modify the search queries for the font descriptors used by the parent [`NSFontCollection`](/documentation/AppKit/NSFontCollection) class.

## Topics

### Creating a Font Collection

[`+  fontCollectionWithDescriptors:`](/documentation/AppKit/NSMutableFontCollection/init(descriptors:))

Creates a mutable font collection containing the fonts that match the specified font descriptors.

[`+  fontCollectionWithLocale:`](/documentation/AppKit/NSMutableFontCollection/init(locale:))

Creates a mutable font collection containing fonts suitable for the specified locale.

[`+  fontCollectionWithName:`](/documentation/AppKit/NSMutableFontCollection/init(name:))

Creates a mutable named font collection object.

[`+  fontCollectionWithName:visibility:`](/documentation/AppKit/NSMutableFontCollection/init(name:visibility:))

Creates a mutable font collection with the specified name and font visibility.

[`fontCollectionWithAllAvailableDescriptors`](/documentation/AppKit/NSMutableFontCollection/withAllAvailableDescriptors)

The mutable font collection that matches all registered fonts.

### Getting the Font Descriptors

[`queryDescriptors`](/documentation/AppKit/NSMutableFontCollection/queryDescriptors)

The font descriptors to include in query results.

[`-  addQueryForDescriptors:`](/documentation/AppKit/NSMutableFontCollection/addQuery(for:))

Edits the query and exclusion arrays by adding the specified font descriptors.

[`-  removeQueryForDescriptors:`](/documentation/AppKit/NSMutableFontCollection/removeQuery(for:))

Edits the query and exclusion arrays by removing the specified font descriptors.

[`exclusionDescriptors`](/documentation/AppKit/NSMutableFontCollection/exclusionDescriptors)

The font descriptors to exclude from query results.

## Relationships

### Conforms To

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

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`NSMutableCopying`](/documentation/Foundation/NSMutableCopying)

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

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

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

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

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

[`NSCopying`](/documentation/Foundation/NSCopying)

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

[`NSCoding`](/documentation/Foundation/NSCoding)

### Inherits From

[`NSFontCollection`](/documentation/AppKit/NSFontCollection)

---

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)