---
title: NSMetadataItem
framework: foundation
role: symbol
role_heading: Class
path: foundation/nsmetadataitem
---

# NSMetadataItem

The metadata associated with a file.

## Declaration

```swift
class NSMetadataItem
```

## Overview

Overview Metadata items provide a simple interface to retrieve the available attribute names and values.

## Topics

### Creating a Metadata Item

- [init(url:)](foundation/nsmetadataitem/init(url:)-9xxs3.md)

### Getting Item Attributes

- [attributes](foundation/nsmetadataitem/attributes.md)
- [value(forAttribute:)](foundation/nsmetadataitem/value(forattribute:).md)
- [values(forAttributes:)](foundation/nsmetadataitem/values(forattributes:).md)

### Item Attribute Keys

- [NSMetadataItemAudiencesKey](foundation/nsmetadataitemaudienceskey.md)
- [NSMetadataItemAudioBitRateKey](foundation/nsmetadataitemaudiobitratekey.md)
- [NSMetadataItemAudioChannelCountKey](foundation/nsmetadataitemaudiochannelcountkey.md)
- [NSMetadataItemAudioEncodingApplicationKey](foundation/nsmetadataitemaudioencodingapplicationkey.md)
- [NSMetadataItemAudioSampleRateKey](foundation/nsmetadataitemaudiosampleratekey.md)
- [NSMetadataItemAudioTrackNumberKey](foundation/nsmetadataitemaudiotracknumberkey.md)
- [NSMetadataItemAuthorAddressesKey](foundation/nsmetadataitemauthoraddresseskey.md)
- [NSMetadataItemAuthorEmailAddressesKey](foundation/nsmetadataitemauthoremailaddresseskey.md)
- [NSMetadataItemAuthorsKey](foundation/nsmetadataitemauthorskey.md)
- [NSMetadataItemAcquisitionMakeKey](foundation/nsmetadataitemacquisitionmakekey.md)
- [NSMetadataItemAcquisitionModelKey](foundation/nsmetadataitemacquisitionmodelkey.md)
- [NSMetadataItemAlbumKey](foundation/nsmetadataitemalbumkey.md)
- [NSMetadataItemAltitudeKey](foundation/nsmetadataitemaltitudekey.md)
- [NSMetadataItemApertureKey](foundation/nsmetadataitemaperturekey.md)
- [NSMetadataItemAppleLoopDescriptorsKey](foundation/nsmetadataitemappleloopdescriptorskey.md)
- [NSMetadataItemAppleLoopsKeyFilterTypeKey](foundation/nsmetadataitemappleloopskeyfiltertypekey.md)
- [NSMetadataItemAppleLoopsLoopModeKey](foundation/nsmetadataitemappleloopsloopmodekey.md)
- [NSMetadataItemAppleLoopsRootKeyKey](foundation/nsmetadataitemappleloopsrootkeykey.md)
- [NSMetadataItemApplicationCategoriesKey](foundation/nsmetadataitemapplicationcategorieskey.md)
- [NSMetadataItemAttributeChangeDateKey](foundation/nsmetadataitemattributechangedatekey.md)
- [NSMetadataItemFSNameKey](foundation/nsmetadataitemfsnamekey.md)
- [NSMetadataItemDisplayNameKey](foundation/nsmetadataitemdisplaynamekey.md)
- [NSMetadataItemURLKey](foundation/nsmetadataitemurlkey.md)
- [NSMetadataItemPathKey](foundation/nsmetadataitempathkey.md)
- [NSMetadataItemFSSizeKey](foundation/nsmetadataitemfssizekey.md)
- [NSMetadataItemFSCreationDateKey](foundation/nsmetadataitemfscreationdatekey.md)
- [NSMetadataItemFSContentChangeDateKey](foundation/nsmetadataitemfscontentchangedatekey.md)
- [NSMetadataItemBitsPerSampleKey](foundation/nsmetadataitembitspersamplekey.md)
- [NSMetadataItemCFBundleIdentifierKey](foundation/nsmetadataitemcfbundleidentifierkey.md)
- [NSMetadataItemCameraOwnerKey](foundation/nsmetadataitemcameraownerkey.md)
- [NSMetadataItemCityKey](foundation/nsmetadataitemcitykey.md)
- [NSMetadataItemCodecsKey](foundation/nsmetadataitemcodecskey.md)
- [NSMetadataItemColorSpaceKey](foundation/nsmetadataitemcolorspacekey.md)
- [NSMetadataItemCommentKey](foundation/nsmetadataitemcommentkey.md)
- [NSMetadataItemComposerKey](foundation/nsmetadataitemcomposerkey.md)
- [NSMetadataItemContactKeywordsKey](foundation/nsmetadataitemcontactkeywordskey.md)
- [NSMetadataItemContentCreationDateKey](foundation/nsmetadataitemcontentcreationdatekey.md)
- [NSMetadataItemContentModificationDateKey](foundation/nsmetadataitemcontentmodificationdatekey.md)
- [NSMetadataItemContentTypeKey](foundation/nsmetadataitemcontenttypekey.md)
- [NSMetadataItemContentTypeTreeKey](foundation/nsmetadataitemcontenttypetreekey.md)
- [NSMetadataItemContributorsKey](foundation/nsmetadataitemcontributorskey.md)
- [NSMetadataItemCopyrightKey](foundation/nsmetadataitemcopyrightkey.md)
- [NSMetadataItemCountryKey](foundation/nsmetadataitemcountrykey.md)
- [NSMetadataItemCoverageKey](foundation/nsmetadataitemcoveragekey.md)
- [NSMetadataItemCreatorKey](foundation/nsmetadataitemcreatorkey.md)
- [NSMetadataItemDateAddedKey](foundation/nsmetadataitemdateaddedkey.md)
- [NSMetadataItemDeliveryTypeKey](foundation/nsmetadataitemdeliverytypekey.md)
- [NSMetadataItemDescriptionKey](foundation/nsmetadataitemdescriptionkey.md)
- [NSMetadataItemDirectorKey](foundation/nsmetadataitemdirectorkey.md)
- [NSMetadataItemDownloadedDateKey](foundation/nsmetadataitemdownloadeddatekey.md)
- [NSMetadataItemDueDateKey](foundation/nsmetadataitemduedatekey.md)
- [NSMetadataItemDurationSecondsKey](foundation/nsmetadataitemdurationsecondskey.md)
- [NSMetadataItemEXIFGPSVersionKey](foundation/nsmetadataitemexifgpsversionkey.md)
- [NSMetadataItemEXIFVersionKey](foundation/nsmetadataitemexifversionkey.md)
- [NSMetadataItemEditorsKey](foundation/nsmetadataitemeditorskey.md)
- [NSMetadataItemEmailAddressesKey](foundation/nsmetadataitememailaddresseskey.md)
- [NSMetadataItemEncodingApplicationsKey](foundation/nsmetadataitemencodingapplicationskey.md)
- [NSMetadataItemExecutableArchitecturesKey](foundation/nsmetadataitemexecutablearchitectureskey.md)
- [NSMetadataItemExecutablePlatformKey](foundation/nsmetadataitemexecutableplatformkey.md)
- [NSMetadataItemExposureModeKey](foundation/nsmetadataitemexposuremodekey.md)
- [NSMetadataItemExposureProgramKey](foundation/nsmetadataitemexposureprogramkey.md)
- [NSMetadataItemExposureTimeSecondsKey](foundation/nsmetadataitemexposuretimesecondskey.md)
- [NSMetadataItemExposureTimeStringKey](foundation/nsmetadataitemexposuretimestringkey.md)
- [NSMetadataItemFNumberKey](foundation/nsmetadataitemfnumberkey.md)
- [NSMetadataItemFinderCommentKey](foundation/nsmetadataitemfindercommentkey.md)
- [NSMetadataItemFlashOnOffKey](foundation/nsmetadataitemflashonoffkey.md)
- [NSMetadataItemFocalLength35mmKey](foundation/nsmetadataitemfocallength35mmkey.md)
- [NSMetadataItemFocalLengthKey](foundation/nsmetadataitemfocallengthkey.md)
- [NSMetadataItemFontsKey](foundation/nsmetadataitemfontskey.md)
- [NSMetadataItemGPSAreaInformationKey](foundation/nsmetadataitemgpsareainformationkey.md)
- [NSMetadataItemGPSDOPKey](foundation/nsmetadataitemgpsdopkey.md)
- [NSMetadataItemGPSDateStampKey](foundation/nsmetadataitemgpsdatestampkey.md)
- [NSMetadataItemGPSDestBearingKey](foundation/nsmetadataitemgpsdestbearingkey.md)
- [NSMetadataItemGPSDestDistanceKey](foundation/nsmetadataitemgpsdestdistancekey.md)
- [NSMetadataItemGPSDestLatitudeKey](foundation/nsmetadataitemgpsdestlatitudekey.md)
- [NSMetadataItemGPSDestLongitudeKey](foundation/nsmetadataitemgpsdestlongitudekey.md)
- [NSMetadataItemGPSDifferentalKey](foundation/nsmetadataitemgpsdifferentalkey.md)
- [NSMetadataItemGPSMapDatumKey](foundation/nsmetadataitemgpsmapdatumkey.md)
- [NSMetadataItemGPSMeasureModeKey](foundation/nsmetadataitemgpsmeasuremodekey.md)
- [NSMetadataItemGPSProcessingMethodKey](foundation/nsmetadataitemgpsprocessingmethodkey.md)
- [NSMetadataItemGPSStatusKey](foundation/nsmetadataitemgpsstatuskey.md)
- [NSMetadataItemGPSTrackKey](foundation/nsmetadataitemgpstrackkey.md)
- [NSMetadataItemGenreKey](foundation/nsmetadataitemgenrekey.md)
- [NSMetadataItemHasAlphaChannelKey](foundation/nsmetadataitemhasalphachannelkey.md)
- [NSMetadataItemHeadlineKey](foundation/nsmetadataitemheadlinekey.md)
- [NSMetadataItemISOSpeedKey](foundation/nsmetadataitemisospeedkey.md)
- [NSMetadataItemIdentifierKey](foundation/nsmetadataitemidentifierkey.md)
- [NSMetadataItemImageDirectionKey](foundation/nsmetadataitemimagedirectionkey.md)
- [NSMetadataItemInformationKey](foundation/nsmetadataiteminformationkey.md)
- [NSMetadataItemInstantMessageAddressesKey](foundation/nsmetadataiteminstantmessageaddresseskey.md)
- [NSMetadataItemInstructionsKey](foundation/nsmetadataiteminstructionskey.md)
- [NSMetadataItemIsApplicationManagedKey](foundation/nsmetadataitemisapplicationmanagedkey.md)
- [NSMetadataItemIsGeneralMIDISequenceKey](foundation/nsmetadataitemisgeneralmidisequencekey.md)
- [NSMetadataItemIsLikelyJunkKey](foundation/nsmetadataitemislikelyjunkkey.md)
- [NSMetadataItemKeySignatureKey](foundation/nsmetadataitemkeysignaturekey.md)
- [NSMetadataItemKeywordsKey](foundation/nsmetadataitemkeywordskey.md)
- [NSMetadataItemKindKey](foundation/nsmetadataitemkindkey.md)
- [NSMetadataItemLanguagesKey](foundation/nsmetadataitemlanguageskey.md)
- [NSMetadataItemLastUsedDateKey](foundation/nsmetadataitemlastuseddatekey.md)
- [NSMetadataItemLatitudeKey](foundation/nsmetadataitemlatitudekey.md)
- [NSMetadataItemLayerNamesKey](foundation/nsmetadataitemlayernameskey.md)
- [NSMetadataItemLensModelKey](foundation/nsmetadataitemlensmodelkey.md)
- [NSMetadataItemLongitudeKey](foundation/nsmetadataitemlongitudekey.md)
- [NSMetadataItemLyricistKey](foundation/nsmetadataitemlyricistkey.md)
- [NSMetadataItemMaxApertureKey](foundation/nsmetadataitemmaxaperturekey.md)
- [NSMetadataItemMediaTypesKey](foundation/nsmetadataitemmediatypeskey.md)
- [NSMetadataItemMeteringModeKey](foundation/nsmetadataitemmeteringmodekey.md)
- [NSMetadataItemMusicalGenreKey](foundation/nsmetadataitemmusicalgenrekey.md)
- [NSMetadataItemMusicalInstrumentCategoryKey](foundation/nsmetadataitemmusicalinstrumentcategorykey.md)
- [NSMetadataItemMusicalInstrumentNameKey](foundation/nsmetadataitemmusicalinstrumentnamekey.md)
- [NSMetadataItemNamedLocationKey](foundation/nsmetadataitemnamedlocationkey.md)
- [NSMetadataItemNumberOfPagesKey](foundation/nsmetadataitemnumberofpageskey.md)
- [NSMetadataItemOrganizationsKey](foundation/nsmetadataitemorganizationskey.md)
- [NSMetadataItemOrientationKey](foundation/nsmetadataitemorientationkey.md)
- [NSMetadataItemOriginalFormatKey](foundation/nsmetadataitemoriginalformatkey.md)
- [NSMetadataItemOriginalSourceKey](foundation/nsmetadataitemoriginalsourcekey.md)
- [NSMetadataItemPageHeightKey](foundation/nsmetadataitempageheightkey.md)
- [NSMetadataItemPageWidthKey](foundation/nsmetadataitempagewidthkey.md)
- [NSMetadataItemParticipantsKey](foundation/nsmetadataitemparticipantskey.md)
- [NSMetadataItemPerformersKey](foundation/nsmetadataitemperformerskey.md)
- [NSMetadataItemPhoneNumbersKey](foundation/nsmetadataitemphonenumberskey.md)
- [NSMetadataItemPixelCountKey](foundation/nsmetadataitempixelcountkey.md)
- [NSMetadataItemPixelHeightKey](foundation/nsmetadataitempixelheightkey.md)
- [NSMetadataItemPixelWidthKey](foundation/nsmetadataitempixelwidthkey.md)
- [NSMetadataItemProducerKey](foundation/nsmetadataitemproducerkey.md)
- [NSMetadataItemProfileNameKey](foundation/nsmetadataitemprofilenamekey.md)
- [NSMetadataItemProjectsKey](foundation/nsmetadataitemprojectskey.md)
- [NSMetadataItemPublishersKey](foundation/nsmetadataitempublisherskey.md)
- [NSMetadataItemRecipientAddressesKey](foundation/nsmetadataitemrecipientaddresseskey.md)
- [NSMetadataItemRecipientEmailAddressesKey](foundation/nsmetadataitemrecipientemailaddresseskey.md)
- [NSMetadataItemRecipientsKey](foundation/nsmetadataitemrecipientskey.md)
- [NSMetadataItemRecordingDateKey](foundation/nsmetadataitemrecordingdatekey.md)
- [NSMetadataItemRecordingYearKey](foundation/nsmetadataitemrecordingyearkey.md)
- [NSMetadataItemRedEyeOnOffKey](foundation/nsmetadataitemredeyeonoffkey.md)
- [NSMetadataItemResolutionHeightDPIKey](foundation/nsmetadataitemresolutionheightdpikey.md)
- [NSMetadataItemResolutionWidthDPIKey](foundation/nsmetadataitemresolutionwidthdpikey.md)
- [NSMetadataItemRightsKey](foundation/nsmetadataitemrightskey.md)
- [NSMetadataItemSecurityMethodKey](foundation/nsmetadataitemsecuritymethodkey.md)
- [NSMetadataItemSpeedKey](foundation/nsmetadataitemspeedkey.md)
- [NSMetadataItemStarRatingKey](foundation/nsmetadataitemstarratingkey.md)
- [NSMetadataItemStateOrProvinceKey](foundation/nsmetadataitemstateorprovincekey.md)
- [NSMetadataItemStreamableKey](foundation/nsmetadataitemstreamablekey.md)
- [NSMetadataItemSubjectKey](foundation/nsmetadataitemsubjectkey.md)
- [NSMetadataItemTempoKey](foundation/nsmetadataitemtempokey.md)
- [NSMetadataItemTextContentKey](foundation/nsmetadataitemtextcontentkey.md)
- [NSMetadataItemThemeKey](foundation/nsmetadataitemthemekey.md)
- [NSMetadataItemTimeSignatureKey](foundation/nsmetadataitemtimesignaturekey.md)
- [NSMetadataItemTimestampKey](foundation/nsmetadataitemtimestampkey.md)
- [NSMetadataItemTitleKey](foundation/nsmetadataitemtitlekey.md)
- [NSMetadataItemTotalBitRateKey](foundation/nsmetadataitemtotalbitratekey.md)
- [NSMetadataItemVersionKey](foundation/nsmetadataitemversionkey.md)
- [NSMetadataItemVideoBitRateKey](foundation/nsmetadataitemvideobitratekey.md)
- [NSMetadataItemWhereFromsKey](foundation/nsmetadataitemwherefromskey.md)
- [NSMetadataItemWhiteBalanceKey](foundation/nsmetadataitemwhitebalancekey.md)

### iCloud Keys

- [NSMetadataItemIsUbiquitousKey](foundation/nsmetadataitemisubiquitouskey.md)
- [NSMetadataUbiquitousItemContainerDisplayNameKey](foundation/nsmetadataubiquitousitemcontainerdisplaynamekey.md)
- [NSMetadataUbiquitousItemDownloadRequestedKey](foundation/nsmetadataubiquitousitemdownloadrequestedkey.md)
- [NSMetadataUbiquitousItemIsExternalDocumentKey](foundation/nsmetadataubiquitousitemisexternaldocumentkey.md)
- [NSMetadataUbiquitousItemURLInLocalContainerKey](foundation/nsmetadataubiquitousitemurlinlocalcontainerkey.md)
- [NSMetadataUbiquitousItemHasUnresolvedConflictsKey](foundation/nsmetadataubiquitousitemhasunresolvedconflictskey.md)
- [NSMetadataUbiquitousItemIsDownloadedKey](foundation/nsmetadataubiquitousitemisdownloadedkey.md)
- [NSMetadataUbiquitousItemIsDownloadingKey](foundation/nsmetadataubiquitousitemisdownloadingkey.md)
- [NSMetadataUbiquitousItemIsUploadedKey](foundation/nsmetadataubiquitousitemisuploadedkey.md)
- [NSMetadataUbiquitousItemIsUploadingKey](foundation/nsmetadataubiquitousitemisuploadingkey.md)
- [NSMetadataUbiquitousItemPercentDownloadedKey](foundation/nsmetadataubiquitousitempercentdownloadedkey.md)
- [NSMetadataUbiquitousItemPercentUploadedKey](foundation/nsmetadataubiquitousitempercentuploadedkey.md)
- [NSMetadataUbiquitousItemDownloadingStatusKey](foundation/nsmetadataubiquitousitemdownloadingstatuskey.md)
- [NSMetadataUbiquitousItemDownloadingErrorKey](foundation/nsmetadataubiquitousitemdownloadingerrorkey.md)
- [NSMetadataUbiquitousItemUploadingErrorKey](foundation/nsmetadataubiquitousitemuploadingerrorkey.md)
- [NSMetadataUbiquitousItemIsSharedKey](foundation/nsmetadataubiquitousitemissharedkey.md)
- [NSMetadataUbiquitousSharedItemCurrentUserPermissionsKey](foundation/nsmetadataubiquitousshareditemcurrentuserpermissionskey.md)
- [NSMetadataUbiquitousSharedItemCurrentUserRoleKey](foundation/nsmetadataubiquitousshareditemcurrentuserrolekey.md)
- [NSMetadataUbiquitousSharedItemMostRecentEditorNameComponentsKey](foundation/nsmetadataubiquitousshareditemmostrecenteditornamecomponentskey.md)
- [NSMetadataUbiquitousSharedItemOwnerNameComponentsKey](foundation/nsmetadataubiquitousshareditemownernamecomponentskey.md)

### iCloud Download Status Values

- [NSMetadataUbiquitousItemDownloadingStatusCurrent](foundation/nsmetadataubiquitousitemdownloadingstatuscurrent.md)
- [NSMetadataUbiquitousItemDownloadingStatusDownloaded](foundation/nsmetadataubiquitousitemdownloadingstatusdownloaded.md)
- [NSMetadataUbiquitousItemDownloadingStatusNotDownloaded](foundation/nsmetadataubiquitousitemdownloadingstatusnotdownloaded.md)

### iCloud Sharing Permissions Values

- [NSMetadataUbiquitousSharedItemPermissionsReadOnly](foundation/nsmetadataubiquitousshareditempermissionsreadonly.md)
- [NSMetadataUbiquitousSharedItemPermissionsReadWrite](foundation/nsmetadataubiquitousshareditempermissionsreadwrite.md)

### iCloud Sharing Role Values

- [NSMetadataUbiquitousSharedItemRoleOwner](foundation/nsmetadataubiquitousshareditemroleowner.md)
- [NSMetadataUbiquitousSharedItemRoleParticipant](foundation/nsmetadataubiquitousshareditemroleparticipant.md)

### Initializers

- [init(URL:)](foundation/nsmetadataitem/init(url:)-viww.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### File Search

- [NSMetadataQuery](foundation/nsmetadataquery.md)
- [NSMetadataQueryDelegate](foundation/nsmetadataquerydelegate.md)