<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AppKit",
  "identifier" : "/documentation/AppKit/NSImage/Name-swift.typealias",
  "metadataVersion" : "0.1.0",
  "role" : "Type Alias",
  "symbol" : {
    "kind" : "Type Alias",
    "modules" : [
      "AppKit"
    ],
    "preciseIdentifier" : "c:@T@NSImageName"
  },
  "title" : "NSImage.Name"
}
-->

# NSImage.Name

Named images, defined by the system or you, for use in your app.

```
typealias Name = String
```

## Discussion

The appearance of system-supplied images can change between releases. If you use an image for its intended purpose (and not because of how it looks), your code should look correct from release to release.

The size and aspect ratio of system images can also change between releases. In some situations, you should explicitly resize images as appropriate for your use. If you use these images in conjunction with an [`NSButtonCell`](/documentation/AppKit/NSButtonCell) object, however, you can use the [`imageScaling`](/documentation/AppKit/NSButtonCell/imageScaling) property of the cell to control scaling instead. Similarly, for an [`NSSegmentedCell`](/documentation/AppKit/NSSegmentedCell) object, you can use the [`setImageScaling(_:forSegment:)`](/documentation/AppKit/NSSegmentedCell/setImageScaling(_:forSegment:)): method to control scaling.

Constants that end in the word “Template” represent template images. These images can be processed into variants appropriate for different situations.  For example, these images can invert in a selected table view row. See [`isTemplate`](/documentation/AppKit/NSImage/isTemplate) for more information.

Some images also contain the word “FreestandingTemplate”.  These images are template images that are appropriate for use as a borderless button—that is, it doesn’t need any extra bezel artwork behind it.

## Topics

### System Images

[`class let actionTemplateName: String`](/documentation/AppKit/NSImage/actionTemplateName)

An action menu template image.

[`class let addTemplateName: String`](/documentation/AppKit/NSImage/addTemplateName)

An add item template image.

[`class let advancedName: String`](/documentation/AppKit/NSImage/advancedName)

Advanced preferences toolbar icon for the preferences window.

[`class let applicationIconName: String`](/documentation/AppKit/NSImage/applicationIconName)

The app’s icon.

[`class let bluetoothTemplateName: String`](/documentation/AppKit/NSImage/bluetoothTemplateName)

A Bluetooth template image.

[`class let bonjourName: String`](/documentation/AppKit/NSImage/bonjourName)

A Bonjour icon.

[`class let bookmarksTemplateName: String`](/documentation/AppKit/NSImage/bookmarksTemplateName)

Bookmarks image suitable for a template.

[`class let cautionName: String`](/documentation/AppKit/NSImage/cautionName)

A caution image.

[`class let colorPanelName: String`](/documentation/AppKit/NSImage/colorPanelName)

A color panel toolbar icon.

[`class let columnViewTemplateName: String`](/documentation/AppKit/NSImage/columnViewTemplateName)

A column view mode template image.

[`class let computerName: String`](/documentation/AppKit/NSImage/computerName)

A computer icon.

[`extern NSImageName const NSImageNameDotMac;`](/documentation/AppKit/NSImageNameDotMac)

A Dot Mac icon.

[`class let enterFullScreenTemplateName: String`](/documentation/AppKit/NSImage/enterFullScreenTemplateName)

An enter full-screen mode template image.

[`class let everyoneName: String`](/documentation/AppKit/NSImage/everyoneName)

Permissions for all users.

[`class let exitFullScreenTemplateName: String`](/documentation/AppKit/NSImage/exitFullScreenTemplateName)

An exit full-screen mode template image.

[`class let flowViewTemplateName: String`](/documentation/AppKit/NSImage/flowViewTemplateName)

A cover flow view mode template image.

[`class let folderName: String`](/documentation/AppKit/NSImage/folderName)

A folder image.

[`class let folderBurnableName: String`](/documentation/AppKit/NSImage/folderBurnableName)

A burnable folder icon.

[`class let folderSmartName: String`](/documentation/AppKit/NSImage/folderSmartName)

A smart folder icon.

[`class let followLinkFreestandingTemplateName: String`](/documentation/AppKit/NSImage/followLinkFreestandingTemplateName)

A link template image.

[`class let fontPanelName: String`](/documentation/AppKit/NSImage/fontPanelName)

A font panel toolbar icon.

[`class let goBackTemplateName: String`](/documentation/AppKit/NSImage/goBackTemplateName)

A “go back” template image.

[`class let goForwardTemplateName: String`](/documentation/AppKit/NSImage/goForwardTemplateName)

A “go forward” template image.

[`class let goLeftTemplateName: String`](/documentation/AppKit/NSImage/goLeftTemplateName)

A “go back” template image.

[`class let goRightTemplateName: String`](/documentation/AppKit/NSImage/goRightTemplateName)

A “go forward” template image.

[`class let homeTemplateName: String`](/documentation/AppKit/NSImage/homeTemplateName)

Home image suitable for a template.

[`class let iChatTheaterTemplateName: String`](/documentation/AppKit/NSImage/iChatTheaterTemplateName)

An iChat Theater template image.

[`class let iconViewTemplateName: String`](/documentation/AppKit/NSImage/iconViewTemplateName)

An icon view mode template image.

[`class let infoName: String`](/documentation/AppKit/NSImage/infoName)

An information toolbar icon.

[`class let invalidDataFreestandingTemplateName: String`](/documentation/AppKit/NSImage/invalidDataFreestandingTemplateName)

A template image used to denote invalid data.

[`class let leftFacingTriangleTemplateName: String`](/documentation/AppKit/NSImage/leftFacingTriangleTemplateName)

A generic left-facing triangle template image.

[`class let listViewTemplateName: String`](/documentation/AppKit/NSImage/listViewTemplateName)

A list view mode template image.

[`class let lockLockedTemplateName: String`](/documentation/AppKit/NSImage/lockLockedTemplateName)

A locked padlock template image.

[`class let lockUnlockedTemplateName: String`](/documentation/AppKit/NSImage/lockUnlockedTemplateName)

An unlocked padlock template image.

[`class let menuMixedStateTemplateName: String`](/documentation/AppKit/NSImage/menuMixedStateTemplateName)

A horizontal dash, for use in menus.

[`class let menuOnStateTemplateName: String`](/documentation/AppKit/NSImage/menuOnStateTemplateName)

A check mark template image, for use in menus.

[`class let mobileMeName: String`](/documentation/AppKit/NSImage/mobileMeName)

A MobileMe icon.

[`class let multipleDocumentsName: String`](/documentation/AppKit/NSImage/multipleDocumentsName)

A drag image for multiple items.

[`class let networkName: String`](/documentation/AppKit/NSImage/networkName)

A network icon.

[`class let pathTemplateName: String`](/documentation/AppKit/NSImage/pathTemplateName)

A path button template image.

[`class let preferencesGeneralName: String`](/documentation/AppKit/NSImage/preferencesGeneralName)

General preferences toolbar icon for the preferences window.

[`class let quickLookTemplateName: String`](/documentation/AppKit/NSImage/quickLookTemplateName)

A Quick Look template image.

[`class let refreshFreestandingTemplateName: String`](/documentation/AppKit/NSImage/refreshFreestandingTemplateName)

A refresh template image.

[`class let refreshTemplateName: String`](/documentation/AppKit/NSImage/refreshTemplateName)

A refresh template image.

[`class let removeTemplateName: String`](/documentation/AppKit/NSImage/removeTemplateName)

A remove item template image.

[`class let revealFreestandingTemplateName: String`](/documentation/AppKit/NSImage/revealFreestandingTemplateName)

A reveal contents template image.

[`class let rightFacingTriangleTemplateName: String`](/documentation/AppKit/NSImage/rightFacingTriangleTemplateName)

A generic right-facing triangle template image.

[`class let shareTemplateName: String`](/documentation/AppKit/NSImage/shareTemplateName)

A share view template image.

[`class let slideshowTemplateName: String`](/documentation/AppKit/NSImage/slideshowTemplateName)

A slideshow template image.

[`class let smartBadgeTemplateName: String`](/documentation/AppKit/NSImage/smartBadgeTemplateName)

A badge for a “smart” item.

[`class let statusAvailableName: String`](/documentation/AppKit/NSImage/statusAvailableName)

Small green indicator, similar to iChat’s available image.

[`class let statusNoneName: String`](/documentation/AppKit/NSImage/statusNoneName)

Small clear indicator.

[`class let statusPartiallyAvailableName: String`](/documentation/AppKit/NSImage/statusPartiallyAvailableName)

Small yellow indicator, similar to iChat’s idle image.

[`class let statusUnavailableName: String`](/documentation/AppKit/NSImage/statusUnavailableName)

Small red indicator, similar to iChat’s unavailable image.

[`class let stopProgressFreestandingTemplateName: String`](/documentation/AppKit/NSImage/stopProgressFreestandingTemplateName)

A stop progress template image.

[`class let stopProgressTemplateName: String`](/documentation/AppKit/NSImage/stopProgressTemplateName)

A stop progress button template image.

[`class let touchBarAddDetailTemplateName: String`](/documentation/AppKit/NSImage/touchBarAddDetailTemplateName)

A template image for showing additional detail for an item.

[`class let touchBarAddTemplateName: String`](/documentation/AppKit/NSImage/touchBarAddTemplateName)

A template image for creating a new item.

[`class let touchBarAlarmTemplateName: String`](/documentation/AppKit/NSImage/touchBarAlarmTemplateName)

A template image for setting or showing an alarm.

[`class let touchBarAudioInputMuteTemplateName: String`](/documentation/AppKit/NSImage/touchBarAudioInputMuteTemplateName)

A template image for muting audio input or denoting that audio input is muted.

[`class let touchBarAudioInputTemplateName: String`](/documentation/AppKit/NSImage/touchBarAudioInputTemplateName)

A template image for denoting audio input.

[`class let touchBarAudioOutputMuteTemplateName: String`](/documentation/AppKit/NSImage/touchBarAudioOutputMuteTemplateName)

A template image for muting audio output or for denoting that audio output is muted.

[`class let touchBarAudioOutputVolumeHighTemplateName: String`](/documentation/AppKit/NSImage/touchBarAudioOutputVolumeHighTemplateName)

A template image for setting the audio output volume to a high level, or for denoting that the audio is at the peak volume.

[`class let touchBarAudioOutputVolumeLowTemplateName: String`](/documentation/AppKit/NSImage/touchBarAudioOutputVolumeLowTemplateName)

A template image for setting the audio output volume to a low level, or for denoting that it is set to a low level.

[`class let touchBarAudioOutputVolumeMediumTemplateName: String`](/documentation/AppKit/NSImage/touchBarAudioOutputVolumeMediumTemplateName)

A template image for setting the audio output volume to a medium level, or for denoting that it is set to a medium level.

[`class let touchBarAudioOutputVolumeOffTemplateName: String`](/documentation/AppKit/NSImage/touchBarAudioOutputVolumeOffTemplateName)

A template image for setting the audio output volume to silent, or for denoting that it is set to silent.

[`class let touchBarBookmarksTemplateName: String`](/documentation/AppKit/NSImage/touchBarBookmarksTemplateName)

A template image for showing app-specific bookmarks.

[`class let touchBarColorPickerFillName: String`](/documentation/AppKit/NSImage/touchBarColorPickerFillName)

A template image for showing a color picker so the user can select a fill color.

[`class let touchBarColorPickerFontName: String`](/documentation/AppKit/NSImage/touchBarColorPickerFontName)

A template image for showing a color picker so the user can select a text color.

[`class let touchBarColorPickerStrokeName: String`](/documentation/AppKit/NSImage/touchBarColorPickerStrokeName)

A template image for showing a color picker so the user can select a stroke color.

[`class let touchBarCommunicationAudioTemplateName: String`](/documentation/AppKit/NSImage/touchBarCommunicationAudioTemplateName)

A template image for initiating or denoting audio communication.

[`class let touchBarCommunicationVideoTemplateName: String`](/documentation/AppKit/NSImage/touchBarCommunicationVideoTemplateName)

A template image for initiating or denoting video communication.

[`class let touchBarComposeTemplateName: String`](/documentation/AppKit/NSImage/touchBarComposeTemplateName)

A template image for opening a new document or view in edit mode.

[`class let touchBarDeleteTemplateName: String`](/documentation/AppKit/NSImage/touchBarDeleteTemplateName)

A template image for deleting the current or selected item.

[`class let touchBarDownloadTemplateName: String`](/documentation/AppKit/NSImage/touchBarDownloadTemplateName)

A template image for downloading an item.

[`class let touchBarEnterFullScreenTemplateName: String`](/documentation/AppKit/NSImage/touchBarEnterFullScreenTemplateName)

A template image for entering full screen mode.

[`class let touchBarExitFullScreenTemplateName: String`](/documentation/AppKit/NSImage/touchBarExitFullScreenTemplateName)

A template image for exiting full screen mode.

[`class let touchBarFastForwardTemplateName: String`](/documentation/AppKit/NSImage/touchBarFastForwardTemplateName)

A template image for moving forward through media playback or slides.

[`class let touchBarFolderCopyToTemplateName: String`](/documentation/AppKit/NSImage/touchBarFolderCopyToTemplateName)

A template image for copying an item to a destination.

[`class let touchBarFolderMoveToTemplateName: String`](/documentation/AppKit/NSImage/touchBarFolderMoveToTemplateName)

A template image for moving an item to a destination.

[`class let touchBarFolderTemplateName: String`](/documentation/AppKit/NSImage/touchBarFolderTemplateName)

A template image for opening or representing a folder.

[`class let touchBarGetInfoTemplateName: String`](/documentation/AppKit/NSImage/touchBarGetInfoTemplateName)

A template image for showing information about an item.

[`class let touchBarGoBackTemplateName: String`](/documentation/AppKit/NSImage/touchBarGoBackTemplateName)

A template image for returning to the previous screen or location.

[`class let touchBarGoDownTemplateName: String`](/documentation/AppKit/NSImage/touchBarGoDownTemplateName)

A template image for moving to the next item in a list.

[`class let touchBarGoForwardTemplateName: String`](/documentation/AppKit/NSImage/touchBarGoForwardTemplateName)

A template image for moving to the next screen or location.

[`class let touchBarGoUpTemplateName: String`](/documentation/AppKit/NSImage/touchBarGoUpTemplateName)

A template image for moving to the previous item in a list.

[`class let touchBarHistoryTemplateName: String`](/documentation/AppKit/NSImage/touchBarHistoryTemplateName)

A template image for showing history information, such as recent downloads.

[`class let touchBarIconViewTemplateName: String`](/documentation/AppKit/NSImage/touchBarIconViewTemplateName)

A template image for showing items in an icon view.

[`class let touchBarListViewTemplateName: String`](/documentation/AppKit/NSImage/touchBarListViewTemplateName)

A template image for showing items in a list view.

[`class let touchBarMailTemplateName: String`](/documentation/AppKit/NSImage/touchBarMailTemplateName)

A template image for creating an email message.

[`class let touchBarNewFolderTemplateName: String`](/documentation/AppKit/NSImage/touchBarNewFolderTemplateName)

A template image for creating a new folder.

[`class let touchBarNewMessageTemplateName: String`](/documentation/AppKit/NSImage/touchBarNewMessageTemplateName)

A template image for creating a new message, or for denoting the use of messaging.

[`class let touchBarOpenInBrowserTemplateName: String`](/documentation/AppKit/NSImage/touchBarOpenInBrowserTemplateName)

A template image for opening an item in the user’s browser.

[`class let touchBarPauseTemplateName: String`](/documentation/AppKit/NSImage/touchBarPauseTemplateName)

A template image for pausing media playback or slides.

[`class let touchBarPlayPauseTemplateName: String`](/documentation/AppKit/NSImage/touchBarPlayPauseTemplateName)

A template image for toggling between playing and pausing media or slides.

[`class let touchBarPlayTemplateName: String`](/documentation/AppKit/NSImage/touchBarPlayTemplateName)

A template image for starting or resuming playback of media or slides.

[`class let touchBarPlayheadTemplateName: String`](/documentation/AppKit/NSImage/touchBarPlayheadTemplateName)

A template image for denoting the current playback position within a timeline track.

[`class let touchBarQuickLookTemplateName: String`](/documentation/AppKit/NSImage/touchBarQuickLookTemplateName)

A template image for opening an item in Quick Look.

[`class let touchBarRecordStartTemplateName: String`](/documentation/AppKit/NSImage/touchBarRecordStartTemplateName)

A template image for starting recording.

[`class let touchBarRecordStopTemplateName: String`](/documentation/AppKit/NSImage/touchBarRecordStopTemplateName)

A template image for stopping recording or stopping playback of media or slides.

[`class let touchBarRefreshTemplateName: String`](/documentation/AppKit/NSImage/touchBarRefreshTemplateName)

A template image for refreshing displayed data.

[`class let touchBarRemoveTemplateName: String`](/documentation/AppKit/NSImage/touchBarRemoveTemplateName)

A template image for removing an item.

[`class let touchBarRewindTemplateName: String`](/documentation/AppKit/NSImage/touchBarRewindTemplateName)

A template image for moving backwards through media or slides.

[`class let touchBarRotateLeftTemplateName: String`](/documentation/AppKit/NSImage/touchBarRotateLeftTemplateName)

A template image for rotating an item counterclockwise.

[`class let touchBarRotateRightTemplateName: String`](/documentation/AppKit/NSImage/touchBarRotateRightTemplateName)

A template image for rotating an item clockwise.

[`class let touchBarSearchTemplateName: String`](/documentation/AppKit/NSImage/touchBarSearchTemplateName)

A template image for showing a search field or for initiating a search.

[`class let touchBarShareTemplateName: String`](/documentation/AppKit/NSImage/touchBarShareTemplateName)

A template image for sharing content with others directly or via social media.

[`class let touchBarSidebarTemplateName: String`](/documentation/AppKit/NSImage/touchBarSidebarTemplateName)

A template image for showing a sidebar in the current view.

[`class let touchBarSkipAhead15SecondsTemplateName: String`](/documentation/AppKit/NSImage/touchBarSkipAhead15SecondsTemplateName)

A template image for skipping ahead 15 seconds during media playback.

[`class let touchBarSkipAhead30SecondsTemplateName: String`](/documentation/AppKit/NSImage/touchBarSkipAhead30SecondsTemplateName)

A template image for skipping ahead 30 seconds during media playback.

[`class let touchBarSkipAheadTemplateName: String`](/documentation/AppKit/NSImage/touchBarSkipAheadTemplateName)

A template image for skipping to the next chapter or location during media playback.

[`class let touchBarSkipBack15SecondsTemplateName: String`](/documentation/AppKit/NSImage/touchBarSkipBack15SecondsTemplateName)

A template image for skipping back 15 seconds during media playback.

[`class let touchBarSkipBack30SecondsTemplateName: String`](/documentation/AppKit/NSImage/touchBarSkipBack30SecondsTemplateName)

A template image for skipping back 30 seconds during media playback.

[`class let touchBarSkipBackTemplateName: String`](/documentation/AppKit/NSImage/touchBarSkipBackTemplateName)

A template image for skipping to the previous chapter or location during media playback.

[`class let touchBarSkipToEndTemplateName: String`](/documentation/AppKit/NSImage/touchBarSkipToEndTemplateName)

A template image for skipping to the end of media playback.

[`class let touchBarSkipToStartTemplateName: String`](/documentation/AppKit/NSImage/touchBarSkipToStartTemplateName)

A template image for skipping to the start of media playback.

[`class let touchBarSlideshowTemplateName: String`](/documentation/AppKit/NSImage/touchBarSlideshowTemplateName)

A template image for starting a slideshow.

[`class let touchBarTagIconTemplateName: String`](/documentation/AppKit/NSImage/touchBarTagIconTemplateName)

A template image for applying a tag to an item.

[`class let touchBarTextBoldTemplateName: String`](/documentation/AppKit/NSImage/touchBarTextBoldTemplateName)

A template image for making selected text bold.

[`class let touchBarTextBoxTemplateName: String`](/documentation/AppKit/NSImage/touchBarTextBoxTemplateName)

A template image for inserting a text box.

[`class let touchBarTextCenterAlignTemplateName: String`](/documentation/AppKit/NSImage/touchBarTextCenterAlignTemplateName)

A template image for centering text.

[`class let touchBarTextItalicTemplateName: String`](/documentation/AppKit/NSImage/touchBarTextItalicTemplateName)

A template image for italicizing the selected text.

[`class let touchBarTextJustifiedAlignTemplateName: String`](/documentation/AppKit/NSImage/touchBarTextJustifiedAlignTemplateName)

A template image for fully justifying text.

[`class let touchBarTextLeftAlignTemplateName: String`](/documentation/AppKit/NSImage/touchBarTextLeftAlignTemplateName)

A template image for aligning text to the left.

[`class let touchBarTextListTemplateName: String`](/documentation/AppKit/NSImage/touchBarTextListTemplateName)

A template image for inserting a list or converting text to list form.

[`class let touchBarTextRightAlignTemplateName: String`](/documentation/AppKit/NSImage/touchBarTextRightAlignTemplateName)

A template image for aligning text to the right.

[`class let touchBarTextStrikethroughTemplateName: String`](/documentation/AppKit/NSImage/touchBarTextStrikethroughTemplateName)

A template image for striking through text.

[`class let touchBarTextUnderlineTemplateName: String`](/documentation/AppKit/NSImage/touchBarTextUnderlineTemplateName)

A template image for underlining text.

[`class let touchBarUserAddTemplateName: String`](/documentation/AppKit/NSImage/touchBarUserAddTemplateName)

A template image for creating a new user account.

[`class let touchBarUserGroupTemplateName: String`](/documentation/AppKit/NSImage/touchBarUserGroupTemplateName)

A template image for showing or representing a group of users.

[`class let touchBarUserTemplateName: String`](/documentation/AppKit/NSImage/touchBarUserTemplateName)

A template image for showing or representing user information.

[`class let touchBarVolumeDownTemplateName: String`](/documentation/AppKit/NSImage/touchBarVolumeDownTemplateName)

A template image for reducing the audio output volume.

[`class let touchBarVolumeUpTemplateName: String`](/documentation/AppKit/NSImage/touchBarVolumeUpTemplateName)

A template image for increasing the audio output volume.

[`class let trashEmptyName: String`](/documentation/AppKit/NSImage/trashEmptyName)

An image of the empty trash can.

[`class let trashFullName: String`](/documentation/AppKit/NSImage/trashFullName)

An image of the full trash can.

[`class let userName: String`](/documentation/AppKit/NSImage/userName)

Permissions for a single user.

[`class let userAccountsName: String`](/documentation/AppKit/NSImage/userAccountsName)

User account toolbar icon for the preferences window.

[`class let userGroupName: String`](/documentation/AppKit/NSImage/userGroupName)

Permissions for a group of users.

[`class let userGuestName: String`](/documentation/AppKit/NSImage/userGuestName)

Permissions for guests.


---

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)