<!--
{
  "availability" : [
    "macOS: 10.7.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSFontCollection/rename(fromName:visibility:toName:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:objc(cs)NSFontCollection(cm)renameFontCollectionWithName:visibility:toName:error:"
  },
  "title" : "rename(fromName:visibility:toName:)"
}
-->

# rename(fromName:visibility:toName:)

Renames the font collection with the specified name and visibility to the second name specified.

```
class func rename(fromName oldName: NSFontCollection.Name, visibility: NSFontCollection.Visibility, toName newName: NSFontCollection.Name) throws
```

## Parameters

`oldName`

The collection to rename.

`visibility`

The visibility of the collection to rename.

`newName`

The new name to give to the collection.

## Discussion

Named collections are shown by user interfaces such as the Font panel. When you change the collection, you must show it again to see the changes reflected on disk or in the Font panel.

> Handling Errors in Swift:
> In Swift, this method returns a nonoptional result and is marked with the `throws` keyword to indicate that it throws an error in cases of failure.
> 
> You call this method in a `try` expression and handle any errors in the `catch` clauses of a `do` statement, as described in [Error Handling](https://docs.swift.org/swift-book/LanguageGuide/ErrorHandling.html) in [The Swift Programming Language](https://docs.swift.org/swift-book/) and `About Imported Cocoa Error Parameters`.

---

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)