# MediaLibrary Constants ## Topics ### Constants [Aperture Media Group Type Identifiers](/documentation/MediaLibrary/aperture-media-group-type-identifiers) Identifiers for media group types in the Aperture media source. These constants are used to specify a media group’s [`typeIdentifier`](/documentation/MediaLibrary/MLMediaGroup/typeIdentifier) attribute. [Final Cut Pro Media Group Type Identifiers](/documentation/MediaLibrary/final-cut-pro-media-group-type-identifiers) Identifiers for media group types in the Final Cut Pro media source. These constants are used to specify a media group’s [`typeIdentifier`](/documentation/MediaLibrary/MLMediaGroup/typeIdentifier) attribute. [Folders Media Group Type Identifiers](/documentation/MediaLibrary/folders-media-group-type-identifiers) Identifiers for media group types in folder-based media sources. These constants are used to specify a media group’s [`typeIdentifier`](/documentation/MediaLibrary/MLMediaGroup/typeIdentifier) attribute. [GarageBand Media Group Type Identifiers](/documentation/MediaLibrary/garageband-media-group-type-identifiers) Identifiers for media group types in the GarageBand media source. These constants are used to specify a media group’s [`typeIdentifier`](/documentation/MediaLibrary/MLMediaGroup/typeIdentifier) attribute. [Logic Media Group Type Identifiers](/documentation/MediaLibrary/logic-media-group-type-identifiers) Identifiers for media group types in the Logic media source. These constants are used to specify a media group’s [`typeIdentifier`](/documentation/MediaLibrary/MLMediaGroup/typeIdentifier) attribute. [`let MLMediaLoadAppFoldersKey: String`](/documentation/MediaLibrary/MLMediaLoadAppFoldersKey) Specifies one or more relative paths inside the caller’s app bundle in which to search for media files. The value for this key is an array of strings (relative paths inside the caller’s app bundle). [`let MLMediaLoadAppleLoops: String`](/documentation/MediaLibrary/MLMediaLoadAppleLoops) Identifies the folder containing audio loops from Apple. [`let MLMediaLoadExcludeSourcesKey: String`](/documentation/MediaLibrary/MLMediaLoadExcludeSourcesKey) Defines which media sources to exclude when loading. This option is processed after [`MLMediaLoadIncludeSourcesKey`](/documentation/MediaLibrary/MLMediaLoadIncludeSourcesKey). The value for this key is an array of strings (media source identifiers). For a list of valid media source identifiers, see [Media Source Identifiers](/documentation/MediaLibrary/media-source-identifiers). [`let MLMediaLoadFoldersKey: String`](/documentation/MediaLibrary/MLMediaLoadFoldersKey) Specifies the well-known folders that should be searched for media files. If this key is not present, none of the well-known folders will be provided. The value for this key is an array of strings (identifiers that correspond to well-known folder locations). For a list of well-known folder identifiers, see [Well-Known Folder Identifiers](/documentation/MediaLibrary/well-known-folder-identifiers). [`let MLMediaLoadIncludeSourcesKey: String`](/documentation/MediaLibrary/MLMediaLoadIncludeSourcesKey) Defines which media sources to include when loading. If not present, load all available media sources. This option is processed after [`MLMediaLoadSourceTypesKey`](/documentation/MediaLibrary/MLMediaLoadSourceTypesKey). If [`MLMediaLoadIncludeSourcesKey`](/documentation/MediaLibrary/MLMediaLoadIncludeSourcesKey) is present but [`MLMediaLoadSourceTypesKey`](/documentation/MediaLibrary/MLMediaLoadSourceTypesKey) is not, then only those sources specified here will be loaded. This is useful for loading a single media source. When both keys are present, this is useful for adding one or more media sources that normally would not appear for the requested library type. The value for this key is an array of strings (media source identifiers). For a list of valid media source identifiers, see [Media Source Identifiers](/documentation/MediaLibrary/media-source-identifiers). [`let MLMediaLoadMoviesFolder: String`](/documentation/MediaLibrary/MLMediaLoadMoviesFolder) Identifies the user’s Movies folder. [`let MLMediaLoadSourceTypesKey: String`](/documentation/MediaLibrary/MLMediaLoadSourceTypesKey) Defines which sources to load based on library type. If not present, this will load all sources. The value for this key is a media source type. For a list of valid media source types, see [`MLMediaSourceType`](/documentation/MediaLibrary/MLMediaSourceType). [`let MLMediaSourceApertureIdentifier: String`](/documentation/MediaLibrary/MLMediaSourceApertureIdentifier) The media source providing content from Aperture. [`let MLMediaSourceAppDefinedFoldersIdentifier: String`](/documentation/MediaLibrary/MLMediaSourceAppDefinedFoldersIdentifier) The media source for app-defined folders. This identifies a media source created from a relative path inside the caller’s app bundle. This source provides data when [`MLMediaLoadAppFoldersKey`](/documentation/MediaLibrary/MLMediaLoadAppFoldersKey) is provided in the options. [`let MLMediaSourceCustomFoldersIdentifier: String`](/documentation/MediaLibrary/MLMediaSourceCustomFoldersIdentifier) The media source for custom folders. Currently, the only custom folder is the folder containing audio loops from Apple. This source provides data when [`MLMediaLoadFoldersKey`](/documentation/MediaLibrary/MLMediaLoadFoldersKey) is provided with the [`MLMediaLoadAppleLoops`](/documentation/MediaLibrary/MLMediaLoadAppleLoops) value. [`let MLMediaSourceFinalCutIdentifier: String`](/documentation/MediaLibrary/MLMediaSourceFinalCutIdentifier) The media source providing content from Final Cut Pro. [`let MLMediaSourceGarageBandIdentifier: String`](/documentation/MediaLibrary/MLMediaSourceGarageBandIdentifier) The media source providing content from GarageBand. [`let MLMediaSourceLogicIdentifier: String`](/documentation/MediaLibrary/MLMediaSourceLogicIdentifier) The media source providing content from Logic. [`let MLMediaSourceMoviesFolderIdentifier: String`](/documentation/MediaLibrary/MLMediaSourceMoviesFolderIdentifier) The media source for the user’s Movies folder. This source provides data when [`MLMediaLoadFoldersKey`](/documentation/MediaLibrary/MLMediaLoadFoldersKey) is provided with the [`MLMediaLoadMoviesFolder`](/documentation/MediaLibrary/MLMediaLoadMoviesFolder) value. [`let MLMediaSourcePhotoBoothIdentifier: String`](/documentation/MediaLibrary/MLMediaSourcePhotoBoothIdentifier) The media source providing content from Photo Booth. [`let MLMediaSourcePhotosIdentifier: String`](/documentation/MediaLibrary/MLMediaSourcePhotosIdentifier) [`struct MLMediaSourceType`](/documentation/MediaLibrary/MLMediaSourceType) Specifies the source type associated with a particular media source. Source type reflects the primary type of media within the source. These constants are used to specify values for [`MLMediaLoadSourceTypesKey`](/documentation/MediaLibrary/MLMediaLoadSourceTypesKey) in the [`init(options:)`](/documentation/MediaLibrary/MLMediaLibrary/init(options:)) method of [`MLMediaLibrary`](/documentation/MediaLibrary/MLMediaLibrary). [`let MLMediaSourceiMovieIdentifier: String`](/documentation/MediaLibrary/MLMediaSourceiMovieIdentifier) The media source providing content from iMovie. [`let MLMediaSourceiPhotoIdentifier: String`](/documentation/MediaLibrary/MLMediaSourceiPhotoIdentifier) The media source providing content from iPhoto. [`let MLMediaSourceiTunesIdentifier: String`](/documentation/MediaLibrary/MLMediaSourceiTunesIdentifier) The media source providing content from iTunes. [`enum MLMediaType`](/documentation/MediaLibrary/MLMediaType) Specifies the media type associated with a particular media object. These constants are used to specify a media object’s [`mediaType`](/documentation/MediaLibrary/MLMediaObject/mediaType) attribute. [`let MLPhotosAlbumTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosAlbumTypeIdentifier) [`let MLPhotosAlbumsGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosAlbumsGroupTypeIdentifier) [`let MLPhotosAllCollectionsGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosAllCollectionsGroupTypeIdentifier) [`let MLPhotosAllMomentsGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosAllMomentsGroupTypeIdentifier) [`let MLPhotosAllPhotosAlbumTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosAllPhotosAlbumTypeIdentifier) [`let MLPhotosAllYearsGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosAllYearsGroupTypeIdentifier) [`let MLPhotosBurstGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosBurstGroupTypeIdentifier) [`let MLPhotosCollectionGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosCollectionGroupTypeIdentifier) [`let MLPhotosDepthEffectGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosDepthEffectGroupTypeIdentifier) [`let MLPhotosFacesAlbumTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosFacesAlbumTypeIdentifier) [`let MLPhotosFavoritesGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosFavoritesGroupTypeIdentifier) [`let MLPhotosFolderTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosFolderTypeIdentifier) [`let MLPhotosFrontCameraGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosFrontCameraGroupTypeIdentifier) [`let MLPhotosLastImportGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosLastImportGroupTypeIdentifier) [`let MLPhotosMomentGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosMomentGroupTypeIdentifier) [`let MLPhotosMyPhotoStreamTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosMyPhotoStreamTypeIdentifier) [`let MLPhotosPanoramasGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosPanoramasGroupTypeIdentifier) [`let MLPhotosPublishedAlbumTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosPublishedAlbumTypeIdentifier) [`let MLPhotosRootGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosRootGroupTypeIdentifier) [`let MLPhotosScreenshotGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosScreenshotGroupTypeIdentifier) [`let MLPhotosSharedGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosSharedGroupTypeIdentifier) [`let MLPhotosSharedPhotoStreamTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosSharedPhotoStreamTypeIdentifier) [`let MLPhotosSloMoGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosSloMoGroupTypeIdentifier) [`let MLPhotosSmartAlbumTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosSmartAlbumTypeIdentifier) [`let MLPhotosTimelapseGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosTimelapseGroupTypeIdentifier) [`let MLPhotosVideosGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosVideosGroupTypeIdentifier) [`let MLPhotosYearGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosYearGroupTypeIdentifier) [`let MLiTunesMusicVideosPlaylistTypeIdentifier: String`](/documentation/MediaLibrary/MLiTunesMusicVideosPlaylistTypeIdentifier) [`let MLiTunesVideoPlaylistTypeIdentifier: String`](/documentation/MediaLibrary/MLiTunesVideoPlaylistTypeIdentifier) [Media Object Attribute Keys](/documentation/MediaLibrary/media-object-attribute-keys) Attribute keys for a media object. These constants are used to specify keys within a media object’s [`attributes`](/documentation/MediaLibrary/MLMediaObject/attributes) dictionary. [iMovie Media Group Type Identifiers](/documentation/MediaLibrary/imovie-media-group-type-identifiers) Identifiers for media group types in the iMovie media source. These constants are used to specify a media group’s [`typeIdentifier`](/documentation/MediaLibrary/MLMediaGroup/typeIdentifier) attribute. [iPhoto Media Group Type Identifiers](/documentation/MediaLibrary/iphoto-media-group-type-identifiers) Identifiers for media group types in the iPhoto media source. These constants are used to specify a media group’s [`typeIdentifier`](/documentation/MediaLibrary/MLMediaGroup/typeIdentifier) attribute. [iTunes Media Group Type Identifiers](/documentation/MediaLibrary/itunes-media-group-type-identifiers) Identifiers for media group types in the iTunes media source. These constants are used to specify a media group’s [`typeIdentifier`](/documentation/MediaLibrary/MLMediaGroup/typeIdentifier) attribute. [`let MLPhotosAnimatedGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosAnimatedGroupTypeIdentifier) [`let MLPhotosLivePhotosGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosLivePhotosGroupTypeIdentifier) [`let MLPhotosLongExposureGroupTypeIdentifier: String`](/documentation/MediaLibrary/MLPhotosLongExposureGroupTypeIdentifier) --- Copyright © 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)