<!--
{
  "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

[`actionTemplateName`](/documentation/AppKit/NSImage/actionTemplateName)

An action menu template image.

[`addTemplateName`](/documentation/AppKit/NSImage/addTemplateName)

An add item template image.

[`advancedName`](/documentation/AppKit/NSImage/advancedName)

Advanced preferences toolbar icon for the preferences window.

[`applicationIconName`](/documentation/AppKit/NSImage/applicationIconName)

The app’s icon.

[`bluetoothTemplateName`](/documentation/AppKit/NSImage/bluetoothTemplateName)

A Bluetooth template image.

[`bonjourName`](/documentation/AppKit/NSImage/bonjourName)

A Bonjour icon.

[`bookmarksTemplateName`](/documentation/AppKit/NSImage/bookmarksTemplateName)

Bookmarks image suitable for a template.

[`cautionName`](/documentation/AppKit/NSImage/cautionName)

A caution image.

[`colorPanelName`](/documentation/AppKit/NSImage/colorPanelName)

A color panel toolbar icon.

[`columnViewTemplateName`](/documentation/AppKit/NSImage/columnViewTemplateName)

A column view mode template image.

[`computerName`](/documentation/AppKit/NSImage/computerName)

A computer icon.

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

A Dot Mac icon.

[`enterFullScreenTemplateName`](/documentation/AppKit/NSImage/enterFullScreenTemplateName)

An enter full-screen mode template image.

[`everyoneName`](/documentation/AppKit/NSImage/everyoneName)

Permissions for all users.

[`exitFullScreenTemplateName`](/documentation/AppKit/NSImage/exitFullScreenTemplateName)

An exit full-screen mode template image.

[`flowViewTemplateName`](/documentation/AppKit/NSImage/flowViewTemplateName)

A cover flow view mode template image.

[`folderName`](/documentation/AppKit/NSImage/folderName)

A folder image.

[`folderBurnableName`](/documentation/AppKit/NSImage/folderBurnableName)

A burnable folder icon.

[`folderSmartName`](/documentation/AppKit/NSImage/folderSmartName)

A smart folder icon.

[`followLinkFreestandingTemplateName`](/documentation/AppKit/NSImage/followLinkFreestandingTemplateName)

A link template image.

[`fontPanelName`](/documentation/AppKit/NSImage/fontPanelName)

A font panel toolbar icon.

[`goBackTemplateName`](/documentation/AppKit/NSImage/goBackTemplateName)

A “go back” template image.

[`goForwardTemplateName`](/documentation/AppKit/NSImage/goForwardTemplateName)

A “go forward” template image.

[`goLeftTemplateName`](/documentation/AppKit/NSImage/goLeftTemplateName)

A “go back” template image.

[`goRightTemplateName`](/documentation/AppKit/NSImage/goRightTemplateName)

A “go forward” template image.

[`homeTemplateName`](/documentation/AppKit/NSImage/homeTemplateName)

Home image suitable for a template.

[`iChatTheaterTemplateName`](/documentation/AppKit/NSImage/iChatTheaterTemplateName)

An iChat Theater template image.

[`iconViewTemplateName`](/documentation/AppKit/NSImage/iconViewTemplateName)

An icon view mode template image.

[`infoName`](/documentation/AppKit/NSImage/infoName)

An information toolbar icon.

[`invalidDataFreestandingTemplateName`](/documentation/AppKit/NSImage/invalidDataFreestandingTemplateName)

A template image used to denote invalid data.

[`leftFacingTriangleTemplateName`](/documentation/AppKit/NSImage/leftFacingTriangleTemplateName)

A generic left-facing triangle template image.

[`listViewTemplateName`](/documentation/AppKit/NSImage/listViewTemplateName)

A list view mode template image.

[`lockLockedTemplateName`](/documentation/AppKit/NSImage/lockLockedTemplateName)

A locked padlock template image.

[`lockUnlockedTemplateName`](/documentation/AppKit/NSImage/lockUnlockedTemplateName)

An unlocked padlock template image.

[`menuMixedStateTemplateName`](/documentation/AppKit/NSImage/menuMixedStateTemplateName)

A horizontal dash, for use in menus.

[`menuOnStateTemplateName`](/documentation/AppKit/NSImage/menuOnStateTemplateName)

A check mark template image, for use in menus.

[`mobileMeName`](/documentation/AppKit/NSImage/mobileMeName)

A MobileMe icon.

[`multipleDocumentsName`](/documentation/AppKit/NSImage/multipleDocumentsName)

A drag image for multiple items.

[`networkName`](/documentation/AppKit/NSImage/networkName)

A network icon.

[`pathTemplateName`](/documentation/AppKit/NSImage/pathTemplateName)

A path button template image.

[`preferencesGeneralName`](/documentation/AppKit/NSImage/preferencesGeneralName)

General preferences toolbar icon for the preferences window.

[`quickLookTemplateName`](/documentation/AppKit/NSImage/quickLookTemplateName)

A Quick Look template image.

[`refreshFreestandingTemplateName`](/documentation/AppKit/NSImage/refreshFreestandingTemplateName)

A refresh template image.

[`refreshTemplateName`](/documentation/AppKit/NSImage/refreshTemplateName)

A refresh template image.

[`removeTemplateName`](/documentation/AppKit/NSImage/removeTemplateName)

A remove item template image.

[`revealFreestandingTemplateName`](/documentation/AppKit/NSImage/revealFreestandingTemplateName)

A reveal contents template image.

[`rightFacingTriangleTemplateName`](/documentation/AppKit/NSImage/rightFacingTriangleTemplateName)

A generic right-facing triangle template image.

[`shareTemplateName`](/documentation/AppKit/NSImage/shareTemplateName)

A share view template image.

[`slideshowTemplateName`](/documentation/AppKit/NSImage/slideshowTemplateName)

A slideshow template image.

[`smartBadgeTemplateName`](/documentation/AppKit/NSImage/smartBadgeTemplateName)

A badge for a “smart” item.

[`statusAvailableName`](/documentation/AppKit/NSImage/statusAvailableName)

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

[`statusNoneName`](/documentation/AppKit/NSImage/statusNoneName)

Small clear indicator.

[`statusPartiallyAvailableName`](/documentation/AppKit/NSImage/statusPartiallyAvailableName)

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

[`statusUnavailableName`](/documentation/AppKit/NSImage/statusUnavailableName)

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

[`stopProgressFreestandingTemplateName`](/documentation/AppKit/NSImage/stopProgressFreestandingTemplateName)

A stop progress template image.

[`stopProgressTemplateName`](/documentation/AppKit/NSImage/stopProgressTemplateName)

A stop progress button template image.

[`touchBarAddDetailTemplateName`](/documentation/AppKit/NSImage/touchBarAddDetailTemplateName)

A template image for showing additional detail for an item.

[`touchBarAddTemplateName`](/documentation/AppKit/NSImage/touchBarAddTemplateName)

A template image for creating a new item.

[`touchBarAlarmTemplateName`](/documentation/AppKit/NSImage/touchBarAlarmTemplateName)

A template image for setting or showing an alarm.

[`touchBarAudioInputMuteTemplateName`](/documentation/AppKit/NSImage/touchBarAudioInputMuteTemplateName)

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

[`touchBarAudioInputTemplateName`](/documentation/AppKit/NSImage/touchBarAudioInputTemplateName)

A template image for denoting audio input.

[`touchBarAudioOutputMuteTemplateName`](/documentation/AppKit/NSImage/touchBarAudioOutputMuteTemplateName)

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

[`touchBarAudioOutputVolumeHighTemplateName`](/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.

[`touchBarAudioOutputVolumeLowTemplateName`](/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.

[`touchBarAudioOutputVolumeMediumTemplateName`](/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.

[`touchBarAudioOutputVolumeOffTemplateName`](/documentation/AppKit/NSImage/touchBarAudioOutputVolumeOffTemplateName)

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

[`touchBarBookmarksTemplateName`](/documentation/AppKit/NSImage/touchBarBookmarksTemplateName)

A template image for showing app-specific bookmarks.

[`touchBarColorPickerFillName`](/documentation/AppKit/NSImage/touchBarColorPickerFillName)

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

[`touchBarColorPickerFontName`](/documentation/AppKit/NSImage/touchBarColorPickerFontName)

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

[`touchBarColorPickerStrokeName`](/documentation/AppKit/NSImage/touchBarColorPickerStrokeName)

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

[`touchBarCommunicationAudioTemplateName`](/documentation/AppKit/NSImage/touchBarCommunicationAudioTemplateName)

A template image for initiating or denoting audio communication.

[`touchBarCommunicationVideoTemplateName`](/documentation/AppKit/NSImage/touchBarCommunicationVideoTemplateName)

A template image for initiating or denoting video communication.

[`touchBarComposeTemplateName`](/documentation/AppKit/NSImage/touchBarComposeTemplateName)

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

[`touchBarDeleteTemplateName`](/documentation/AppKit/NSImage/touchBarDeleteTemplateName)

A template image for deleting the current or selected item.

[`touchBarDownloadTemplateName`](/documentation/AppKit/NSImage/touchBarDownloadTemplateName)

A template image for downloading an item.

[`touchBarEnterFullScreenTemplateName`](/documentation/AppKit/NSImage/touchBarEnterFullScreenTemplateName)

A template image for entering full screen mode.

[`touchBarExitFullScreenTemplateName`](/documentation/AppKit/NSImage/touchBarExitFullScreenTemplateName)

A template image for exiting full screen mode.

[`touchBarFastForwardTemplateName`](/documentation/AppKit/NSImage/touchBarFastForwardTemplateName)

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

[`touchBarFolderCopyToTemplateName`](/documentation/AppKit/NSImage/touchBarFolderCopyToTemplateName)

A template image for copying an item to a destination.

[`touchBarFolderMoveToTemplateName`](/documentation/AppKit/NSImage/touchBarFolderMoveToTemplateName)

A template image for moving an item to a destination.

[`touchBarFolderTemplateName`](/documentation/AppKit/NSImage/touchBarFolderTemplateName)

A template image for opening or representing a folder.

[`touchBarGetInfoTemplateName`](/documentation/AppKit/NSImage/touchBarGetInfoTemplateName)

A template image for showing information about an item.

[`touchBarGoBackTemplateName`](/documentation/AppKit/NSImage/touchBarGoBackTemplateName)

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

[`touchBarGoDownTemplateName`](/documentation/AppKit/NSImage/touchBarGoDownTemplateName)

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

[`touchBarGoForwardTemplateName`](/documentation/AppKit/NSImage/touchBarGoForwardTemplateName)

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

[`touchBarGoUpTemplateName`](/documentation/AppKit/NSImage/touchBarGoUpTemplateName)

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

[`touchBarHistoryTemplateName`](/documentation/AppKit/NSImage/touchBarHistoryTemplateName)

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

[`touchBarIconViewTemplateName`](/documentation/AppKit/NSImage/touchBarIconViewTemplateName)

A template image for showing items in an icon view.

[`touchBarListViewTemplateName`](/documentation/AppKit/NSImage/touchBarListViewTemplateName)

A template image for showing items in a list view.

[`touchBarMailTemplateName`](/documentation/AppKit/NSImage/touchBarMailTemplateName)

A template image for creating an email message.

[`touchBarNewFolderTemplateName`](/documentation/AppKit/NSImage/touchBarNewFolderTemplateName)

A template image for creating a new folder.

[`touchBarNewMessageTemplateName`](/documentation/AppKit/NSImage/touchBarNewMessageTemplateName)

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

[`touchBarOpenInBrowserTemplateName`](/documentation/AppKit/NSImage/touchBarOpenInBrowserTemplateName)

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

[`touchBarPauseTemplateName`](/documentation/AppKit/NSImage/touchBarPauseTemplateName)

A template image for pausing media playback or slides.

[`touchBarPlayPauseTemplateName`](/documentation/AppKit/NSImage/touchBarPlayPauseTemplateName)

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

[`touchBarPlayTemplateName`](/documentation/AppKit/NSImage/touchBarPlayTemplateName)

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

[`touchBarPlayheadTemplateName`](/documentation/AppKit/NSImage/touchBarPlayheadTemplateName)

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

[`touchBarQuickLookTemplateName`](/documentation/AppKit/NSImage/touchBarQuickLookTemplateName)

A template image for opening an item in Quick Look.

[`touchBarRecordStartTemplateName`](/documentation/AppKit/NSImage/touchBarRecordStartTemplateName)

A template image for starting recording.

[`touchBarRecordStopTemplateName`](/documentation/AppKit/NSImage/touchBarRecordStopTemplateName)

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

[`touchBarRefreshTemplateName`](/documentation/AppKit/NSImage/touchBarRefreshTemplateName)

A template image for refreshing displayed data.

[`touchBarRemoveTemplateName`](/documentation/AppKit/NSImage/touchBarRemoveTemplateName)

A template image for removing an item.

[`touchBarRewindTemplateName`](/documentation/AppKit/NSImage/touchBarRewindTemplateName)

A template image for moving backwards through media or slides.

[`touchBarRotateLeftTemplateName`](/documentation/AppKit/NSImage/touchBarRotateLeftTemplateName)

A template image for rotating an item counterclockwise.

[`touchBarRotateRightTemplateName`](/documentation/AppKit/NSImage/touchBarRotateRightTemplateName)

A template image for rotating an item clockwise.

[`touchBarSearchTemplateName`](/documentation/AppKit/NSImage/touchBarSearchTemplateName)

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

[`touchBarShareTemplateName`](/documentation/AppKit/NSImage/touchBarShareTemplateName)

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

[`touchBarSidebarTemplateName`](/documentation/AppKit/NSImage/touchBarSidebarTemplateName)

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

[`touchBarSkipAhead15SecondsTemplateName`](/documentation/AppKit/NSImage/touchBarSkipAhead15SecondsTemplateName)

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

[`touchBarSkipAhead30SecondsTemplateName`](/documentation/AppKit/NSImage/touchBarSkipAhead30SecondsTemplateName)

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

[`touchBarSkipAheadTemplateName`](/documentation/AppKit/NSImage/touchBarSkipAheadTemplateName)

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

[`touchBarSkipBack15SecondsTemplateName`](/documentation/AppKit/NSImage/touchBarSkipBack15SecondsTemplateName)

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

[`touchBarSkipBack30SecondsTemplateName`](/documentation/AppKit/NSImage/touchBarSkipBack30SecondsTemplateName)

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

[`touchBarSkipBackTemplateName`](/documentation/AppKit/NSImage/touchBarSkipBackTemplateName)

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

[`touchBarSkipToEndTemplateName`](/documentation/AppKit/NSImage/touchBarSkipToEndTemplateName)

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

[`touchBarSkipToStartTemplateName`](/documentation/AppKit/NSImage/touchBarSkipToStartTemplateName)

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

[`touchBarSlideshowTemplateName`](/documentation/AppKit/NSImage/touchBarSlideshowTemplateName)

A template image for starting a slideshow.

[`touchBarTagIconTemplateName`](/documentation/AppKit/NSImage/touchBarTagIconTemplateName)

A template image for applying a tag to an item.

[`touchBarTextBoldTemplateName`](/documentation/AppKit/NSImage/touchBarTextBoldTemplateName)

A template image for making selected text bold.

[`touchBarTextBoxTemplateName`](/documentation/AppKit/NSImage/touchBarTextBoxTemplateName)

A template image for inserting a text box.

[`touchBarTextCenterAlignTemplateName`](/documentation/AppKit/NSImage/touchBarTextCenterAlignTemplateName)

A template image for centering text.

[`touchBarTextItalicTemplateName`](/documentation/AppKit/NSImage/touchBarTextItalicTemplateName)

A template image for italicizing the selected text.

[`touchBarTextJustifiedAlignTemplateName`](/documentation/AppKit/NSImage/touchBarTextJustifiedAlignTemplateName)

A template image for fully justifying text.

[`touchBarTextLeftAlignTemplateName`](/documentation/AppKit/NSImage/touchBarTextLeftAlignTemplateName)

A template image for aligning text to the left.

[`touchBarTextListTemplateName`](/documentation/AppKit/NSImage/touchBarTextListTemplateName)

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

[`touchBarTextRightAlignTemplateName`](/documentation/AppKit/NSImage/touchBarTextRightAlignTemplateName)

A template image for aligning text to the right.

[`touchBarTextStrikethroughTemplateName`](/documentation/AppKit/NSImage/touchBarTextStrikethroughTemplateName)

A template image for striking through text.

[`touchBarTextUnderlineTemplateName`](/documentation/AppKit/NSImage/touchBarTextUnderlineTemplateName)

A template image for underlining text.

[`touchBarUserAddTemplateName`](/documentation/AppKit/NSImage/touchBarUserAddTemplateName)

A template image for creating a new user account.

[`touchBarUserGroupTemplateName`](/documentation/AppKit/NSImage/touchBarUserGroupTemplateName)

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

[`touchBarUserTemplateName`](/documentation/AppKit/NSImage/touchBarUserTemplateName)

A template image for showing or representing user information.

[`touchBarVolumeDownTemplateName`](/documentation/AppKit/NSImage/touchBarVolumeDownTemplateName)

A template image for reducing the audio output volume.

[`touchBarVolumeUpTemplateName`](/documentation/AppKit/NSImage/touchBarVolumeUpTemplateName)

A template image for increasing the audio output volume.

[`trashEmptyName`](/documentation/AppKit/NSImage/trashEmptyName)

An image of the empty trash can.

[`trashFullName`](/documentation/AppKit/NSImage/trashFullName)

An image of the full trash can.

[`userName`](/documentation/AppKit/NSImage/userName)

Permissions for a single user.

[`userAccountsName`](/documentation/AppKit/NSImage/userAccountsName)

User account toolbar icon for the preferences window.

[`userGroupName`](/documentation/AppKit/NSImage/userGroupName)

Permissions for a group of users.

[`userGuestName`](/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)