--- title: NSImage.Name framework: appkit role: symbol role_heading: Type Alias path: appkit/nsimage/name-swift.typealias --- # NSImage.Name Named images, defined by the system or you, for use in your app. ## Declaration ```swift typealias Name = String ``` ## Discussion 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 object, however, you can use the imageScaling property of the cell to control scaling instead. Similarly, for an NSSegmentedCell object, you can use the 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 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](appkit/nsimage/actiontemplatename.md) - [addTemplateName](appkit/nsimage/addtemplatename.md) - [advancedName](appkit/nsimage/advancedname.md) - [applicationIconName](appkit/nsimage/applicationiconname.md) - [bluetoothTemplateName](appkit/nsimage/bluetoothtemplatename.md) - [bonjourName](appkit/nsimage/bonjourname.md) - [bookmarksTemplateName](appkit/nsimage/bookmarkstemplatename.md) - [cautionName](appkit/nsimage/cautionname.md) - [colorPanelName](appkit/nsimage/colorpanelname.md) - [columnViewTemplateName](appkit/nsimage/columnviewtemplatename.md) - [computerName](appkit/nsimage/computername.md) - [enterFullScreenTemplateName](appkit/nsimage/enterfullscreentemplatename.md) - [everyoneName](appkit/nsimage/everyonename.md) - [exitFullScreenTemplateName](appkit/nsimage/exitfullscreentemplatename.md) - [flowViewTemplateName](appkit/nsimage/flowviewtemplatename.md) - [folderName](appkit/nsimage/foldername.md) - [folderBurnableName](appkit/nsimage/folderburnablename.md) - [folderSmartName](appkit/nsimage/foldersmartname.md) - [followLinkFreestandingTemplateName](appkit/nsimage/followlinkfreestandingtemplatename.md) - [fontPanelName](appkit/nsimage/fontpanelname.md) - [goBackTemplateName](appkit/nsimage/gobacktemplatename.md) - [goForwardTemplateName](appkit/nsimage/goforwardtemplatename.md) - [goLeftTemplateName](appkit/nsimage/golefttemplatename.md) - [goRightTemplateName](appkit/nsimage/gorighttemplatename.md) - [homeTemplateName](appkit/nsimage/hometemplatename.md) - [iChatTheaterTemplateName](appkit/nsimage/ichattheatertemplatename.md) - [iconViewTemplateName](appkit/nsimage/iconviewtemplatename.md) - [infoName](appkit/nsimage/infoname.md) - [invalidDataFreestandingTemplateName](appkit/nsimage/invaliddatafreestandingtemplatename.md) - [leftFacingTriangleTemplateName](appkit/nsimage/leftfacingtriangletemplatename.md) - [listViewTemplateName](appkit/nsimage/listviewtemplatename.md) - [lockLockedTemplateName](appkit/nsimage/locklockedtemplatename.md) - [lockUnlockedTemplateName](appkit/nsimage/lockunlockedtemplatename.md) - [menuMixedStateTemplateName](appkit/nsimage/menumixedstatetemplatename.md) - [menuOnStateTemplateName](appkit/nsimage/menuonstatetemplatename.md) - [mobileMeName](appkit/nsimage/mobilemename.md) - [multipleDocumentsName](appkit/nsimage/multipledocumentsname.md) - [networkName](appkit/nsimage/networkname.md) - [pathTemplateName](appkit/nsimage/pathtemplatename.md) - [preferencesGeneralName](appkit/nsimage/preferencesgeneralname.md) - [quickLookTemplateName](appkit/nsimage/quicklooktemplatename.md) - [refreshFreestandingTemplateName](appkit/nsimage/refreshfreestandingtemplatename.md) - [refreshTemplateName](appkit/nsimage/refreshtemplatename.md) - [removeTemplateName](appkit/nsimage/removetemplatename.md) - [revealFreestandingTemplateName](appkit/nsimage/revealfreestandingtemplatename.md) - [rightFacingTriangleTemplateName](appkit/nsimage/rightfacingtriangletemplatename.md) - [shareTemplateName](appkit/nsimage/sharetemplatename.md) - [slideshowTemplateName](appkit/nsimage/slideshowtemplatename.md) - [smartBadgeTemplateName](appkit/nsimage/smartbadgetemplatename.md) - [statusAvailableName](appkit/nsimage/statusavailablename.md) - [statusNoneName](appkit/nsimage/statusnonename.md) - [statusPartiallyAvailableName](appkit/nsimage/statuspartiallyavailablename.md) - [statusUnavailableName](appkit/nsimage/statusunavailablename.md) - [stopProgressFreestandingTemplateName](appkit/nsimage/stopprogressfreestandingtemplatename.md) - [stopProgressTemplateName](appkit/nsimage/stopprogresstemplatename.md) - [touchBarAddDetailTemplateName](appkit/nsimage/touchbaradddetailtemplatename.md) - [touchBarAddTemplateName](appkit/nsimage/touchbaraddtemplatename.md) - [touchBarAlarmTemplateName](appkit/nsimage/touchbaralarmtemplatename.md) - [touchBarAudioInputMuteTemplateName](appkit/nsimage/touchbaraudioinputmutetemplatename.md) - [touchBarAudioInputTemplateName](appkit/nsimage/touchbaraudioinputtemplatename.md) - [touchBarAudioOutputMuteTemplateName](appkit/nsimage/touchbaraudiooutputmutetemplatename.md) - [touchBarAudioOutputVolumeHighTemplateName](appkit/nsimage/touchbaraudiooutputvolumehightemplatename.md) - [touchBarAudioOutputVolumeLowTemplateName](appkit/nsimage/touchbaraudiooutputvolumelowtemplatename.md) - [touchBarAudioOutputVolumeMediumTemplateName](appkit/nsimage/touchbaraudiooutputvolumemediumtemplatename.md) - [touchBarAudioOutputVolumeOffTemplateName](appkit/nsimage/touchbaraudiooutputvolumeofftemplatename.md) - [touchBarBookmarksTemplateName](appkit/nsimage/touchbarbookmarkstemplatename.md) - [touchBarColorPickerFillName](appkit/nsimage/touchbarcolorpickerfillname.md) - [touchBarColorPickerFontName](appkit/nsimage/touchbarcolorpickerfontname.md) - [touchBarColorPickerStrokeName](appkit/nsimage/touchbarcolorpickerstrokename.md) - [touchBarCommunicationAudioTemplateName](appkit/nsimage/touchbarcommunicationaudiotemplatename.md) - [touchBarCommunicationVideoTemplateName](appkit/nsimage/touchbarcommunicationvideotemplatename.md) - [touchBarComposeTemplateName](appkit/nsimage/touchbarcomposetemplatename.md) - [touchBarDeleteTemplateName](appkit/nsimage/touchbardeletetemplatename.md) - [touchBarDownloadTemplateName](appkit/nsimage/touchbardownloadtemplatename.md) - [touchBarEnterFullScreenTemplateName](appkit/nsimage/touchbarenterfullscreentemplatename.md) - [touchBarExitFullScreenTemplateName](appkit/nsimage/touchbarexitfullscreentemplatename.md) - [touchBarFastForwardTemplateName](appkit/nsimage/touchbarfastforwardtemplatename.md) - [touchBarFolderCopyToTemplateName](appkit/nsimage/touchbarfoldercopytotemplatename.md) - [touchBarFolderMoveToTemplateName](appkit/nsimage/touchbarfoldermovetotemplatename.md) - [touchBarFolderTemplateName](appkit/nsimage/touchbarfoldertemplatename.md) - [touchBarGetInfoTemplateName](appkit/nsimage/touchbargetinfotemplatename.md) - [touchBarGoBackTemplateName](appkit/nsimage/touchbargobacktemplatename.md) - [touchBarGoDownTemplateName](appkit/nsimage/touchbargodowntemplatename.md) - [touchBarGoForwardTemplateName](appkit/nsimage/touchbargoforwardtemplatename.md) - [touchBarGoUpTemplateName](appkit/nsimage/touchbargouptemplatename.md) - [touchBarHistoryTemplateName](appkit/nsimage/touchbarhistorytemplatename.md) - [touchBarIconViewTemplateName](appkit/nsimage/touchbariconviewtemplatename.md) - [touchBarListViewTemplateName](appkit/nsimage/touchbarlistviewtemplatename.md) - [touchBarMailTemplateName](appkit/nsimage/touchbarmailtemplatename.md) - [touchBarNewFolderTemplateName](appkit/nsimage/touchbarnewfoldertemplatename.md) - [touchBarNewMessageTemplateName](appkit/nsimage/touchbarnewmessagetemplatename.md) - [touchBarOpenInBrowserTemplateName](appkit/nsimage/touchbaropeninbrowsertemplatename.md) - [touchBarPauseTemplateName](appkit/nsimage/touchbarpausetemplatename.md) - [touchBarPlayPauseTemplateName](appkit/nsimage/touchbarplaypausetemplatename.md) - [touchBarPlayTemplateName](appkit/nsimage/touchbarplaytemplatename.md) - [touchBarPlayheadTemplateName](appkit/nsimage/touchbarplayheadtemplatename.md) - [touchBarQuickLookTemplateName](appkit/nsimage/touchbarquicklooktemplatename.md) - [touchBarRecordStartTemplateName](appkit/nsimage/touchbarrecordstarttemplatename.md) - [touchBarRecordStopTemplateName](appkit/nsimage/touchbarrecordstoptemplatename.md) - [touchBarRefreshTemplateName](appkit/nsimage/touchbarrefreshtemplatename.md) - [touchBarRemoveTemplateName](appkit/nsimage/touchbarremovetemplatename.md) - [touchBarRewindTemplateName](appkit/nsimage/touchbarrewindtemplatename.md) - [touchBarRotateLeftTemplateName](appkit/nsimage/touchbarrotatelefttemplatename.md) - [touchBarRotateRightTemplateName](appkit/nsimage/touchbarrotaterighttemplatename.md) - [touchBarSearchTemplateName](appkit/nsimage/touchbarsearchtemplatename.md) - [touchBarShareTemplateName](appkit/nsimage/touchbarsharetemplatename.md) - [touchBarSidebarTemplateName](appkit/nsimage/touchbarsidebartemplatename.md) - [touchBarSkipAhead15SecondsTemplateName](appkit/nsimage/touchbarskipahead15secondstemplatename.md) - [touchBarSkipAhead30SecondsTemplateName](appkit/nsimage/touchbarskipahead30secondstemplatename.md) - [touchBarSkipAheadTemplateName](appkit/nsimage/touchbarskipaheadtemplatename.md) - [touchBarSkipBack15SecondsTemplateName](appkit/nsimage/touchbarskipback15secondstemplatename.md) - [touchBarSkipBack30SecondsTemplateName](appkit/nsimage/touchbarskipback30secondstemplatename.md) - [touchBarSkipBackTemplateName](appkit/nsimage/touchbarskipbacktemplatename.md) - [touchBarSkipToEndTemplateName](appkit/nsimage/touchbarskiptoendtemplatename.md) - [touchBarSkipToStartTemplateName](appkit/nsimage/touchbarskiptostarttemplatename.md) - [touchBarSlideshowTemplateName](appkit/nsimage/touchbarslideshowtemplatename.md) - [touchBarTagIconTemplateName](appkit/nsimage/touchbartagicontemplatename.md) - [touchBarTextBoldTemplateName](appkit/nsimage/touchbartextboldtemplatename.md) - [touchBarTextBoxTemplateName](appkit/nsimage/touchbartextboxtemplatename.md) - [touchBarTextCenterAlignTemplateName](appkit/nsimage/touchbartextcenteraligntemplatename.md) - [touchBarTextItalicTemplateName](appkit/nsimage/touchbartextitalictemplatename.md) - [touchBarTextJustifiedAlignTemplateName](appkit/nsimage/touchbartextjustifiedaligntemplatename.md) - [touchBarTextLeftAlignTemplateName](appkit/nsimage/touchbartextleftaligntemplatename.md) - [touchBarTextListTemplateName](appkit/nsimage/touchbartextlisttemplatename.md) - [touchBarTextRightAlignTemplateName](appkit/nsimage/touchbartextrightaligntemplatename.md) - [touchBarTextStrikethroughTemplateName](appkit/nsimage/touchbartextstrikethroughtemplatename.md) - [touchBarTextUnderlineTemplateName](appkit/nsimage/touchbartextunderlinetemplatename.md) - [touchBarUserAddTemplateName](appkit/nsimage/touchbaruseraddtemplatename.md) - [touchBarUserGroupTemplateName](appkit/nsimage/touchbarusergrouptemplatename.md) - [touchBarUserTemplateName](appkit/nsimage/touchbarusertemplatename.md) - [touchBarVolumeDownTemplateName](appkit/nsimage/touchbarvolumedowntemplatename.md) - [touchBarVolumeUpTemplateName](appkit/nsimage/touchbarvolumeuptemplatename.md) - [trashEmptyName](appkit/nsimage/trashemptyname.md) - [trashFullName](appkit/nsimage/trashfullname.md) - [userName](appkit/nsimage/username.md) - [userAccountsName](appkit/nsimage/useraccountsname.md) - [userGroupName](appkit/nsimage/usergroupname.md) - [userGuestName](appkit/nsimage/userguestname.md) ## See Also ### Creating Images by Name - [Configuring and displaying symbol images in your UI](uikit/configuring-and-displaying-symbol-images-in-your-ui.md) - [init(named:)](appkit/nsimage/init(named:).md) - [init(systemSymbolName:accessibilityDescription:)](appkit/nsimage/init(systemsymbolname:accessibilitydescription:).md) - [init(systemSymbolName:variableValue:accessibilityDescription:)](appkit/nsimage/init(systemsymbolname:variablevalue:accessibilitydescription:).md) - [init(symbolName:variableValue:)](appkit/nsimage/init(symbolname:variablevalue:).md) - [init(symbolName:bundle:variableValue:)](appkit/nsimage/init(symbolname:bundle:variablevalue:).md) - [init(resource:)](appkit/nsimage/init(resource:).md) - [setName(_:)](appkit/nsimage/setname(_:).md) - [name()](appkit/nsimage/name().md) - [init(imageLiteralResourceName:)](appkit/nsimage/init(imageliteralresourcename:).md)