# Photos Make your photo and video app’s actions available to Apple Intelligence and Siri by adopting schemas for common photo and video actions. ## Discussion The `.photos` domain defines app schemas that provide a structured representation for common photo and video actions and content. Apply schemas in the `.photos` domain to make your app’s photo and video functionality available to Apple Intelligence and Siri. Each schema defines the requirements for intents, parameters, and results so people get a consistent experience across photo and video apps. For example, a person can edit a photo on different apps that support the [`editAsset`](/documentation/AppIntents/AppSchema/PhotosIntent/editAsset) schema with the same phrases. Most schemas in this domain operate on assets that are already in your app’s library. The exception is [`createAssets`](/documentation/AppIntents/AppSchema/PhotosIntent/createAssets), which adds new assets from an external source. The following table maps example phrases that apply to each schema: |Photos intent schemas |Example phrases | |----------------------------------------------------------------------------------------------------|------------------------------------------------------------------| |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/addAssetsToAlbum`` |“Add DSC_001.JPEG to the 2024 album.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/cleanupPhoto`` |“Clean up.” or “Remove the clutter.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/createAlbum`` |“Create a new album named pics.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/createAssets`` |“Save these to my photos.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/crop`` |“Crop this photo.” or “Trim a bit off the borders.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/deleteAlbum`` |“Trash this album.” or “Get rid of vacation 2024.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/deleteAssets`` |“Delete this photo.” or “Get rid of the three most recent photos.”| |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/duplicateAssets`` |“Duplicate DSC_001.JPEG.” or “Make a copy of DSC_0123.JPEG.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/editAsset`` |“Edit this photo.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/openAlbum`` |“Open the 2024 album.” or “Show me 2024.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/openAsset`` |“Open DSC_0123.JPEG.” or “Play IMG_4567.MOV.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/postToSharedAlbum`` |“Share DSC_001.JPEG to the baby shared album.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/removeAssetsFromAlbum``|“Remove this photo from my shared album.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/setFilter`` |“Apply the dramatic effect.” or “Remove the filter.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/setRotation`` |“Rotate this photo clockwise.” or “Rotate this photo left.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/setWarmth`` |“Apply a warmth value of negative fifty.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/straighten`` |“Straighten this photo.” or “Make this photo straight.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/toggleSuggestedEdits`` |“Enhance this photo.” or “Make this photo better.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/updateAlbum`` |“Rename vacation 2024 to trip.” | |``doc://com.apple.AppIntents/documentation/AppIntents/AppSchema/PhotosIntent/updateAsset`` |“Favorite this photo.” or “Hide this photo.” | > Tip: Xcode generates a template implementation when you type `photos_` and select a schema from the suggestions list. For more information about making your app’s actions available to Apple Intelligence and Siri, see [Apple Intelligence and Siri AI](/documentation/AppIntents/apple-intelligence-and-siri-ai). ## Topics ### Essentials [Integrating your photo app with Apple Intelligence](/documentation/AppIntents/integrating-your-photo-app-with-apple-intelligence) Adopt photo schemas so people can edit and manage photos with Siri. ### Actions [`addAssetsToAlbum`](/documentation/AppIntents/AppSchema/PhotosIntent/addAssetsToAlbum) An intent schema that adds the provided photos to the provided album. [`cleanupPhoto`](/documentation/AppIntents/AppSchema/PhotosIntent/cleanupPhoto) An intent schema that removes distracting objects in a photo. [`copyEdits`](/documentation/AppIntents/AppSchema/PhotosIntent/copyEdits) An intent schema that copies edits from the provided photo. [`createAlbum`](/documentation/AppIntents/AppSchema/PhotosIntent/createAlbum) An intent schema that creates an album. [`createAssets`](/documentation/AppIntents/AppSchema/PhotosIntent/createAssets) An intent schema that creates photos from the provided files. [`crop`](/documentation/AppIntents/AppSchema/PhotosIntent/crop) An intent schema that crops a photo. [`deleteAlbum`](/documentation/AppIntents/AppSchema/PhotosIntent/deleteAlbum) An intent schema that deletes the provided albums. [`deleteAssets`](/documentation/AppIntents/AppSchema/PhotosIntent/deleteAssets) An intent schema that deletes the provided photos. [`duplicateAssets`](/documentation/AppIntents/AppSchema/PhotosIntent/duplicateAssets) An intent schema that duplicates the selected photos. [`editAsset`](/documentation/AppIntents/AppSchema/PhotosIntent/editAsset) An intent schema that opens a photo for editing. [`openAlbum`](/documentation/AppIntents/AppSchema/PhotosIntent/openAlbum) An intent schema that opens the provided album. [`openAsset`](/documentation/AppIntents/AppSchema/PhotosIntent/openAsset) An intent schema that opens the app to a photo. [`pasteEdits`](/documentation/AppIntents/AppSchema/PhotosIntent/pasteEdits) An intent schema that pastes edits to the provided photo. [`postToSharedAlbum`](/documentation/AppIntents/AppSchema/PhotosIntent/postToSharedAlbum) An intent schema that posts the provided photos or files and optional comment to the provided shared album. [`removeAssetsFromAlbum`](/documentation/AppIntents/AppSchema/PhotosIntent/removeAssetsFromAlbum) An intent schema that removes the provided photos from the provided album. [`setDepth`](/documentation/AppIntents/AppSchema/PhotosIntent/setDepth) An intent schema that sets the depth value of a photo. [`setExposure`](/documentation/AppIntents/AppSchema/PhotosIntent/setExposure) An intent schema that configures the exposure for a photo. [`setFilter`](/documentation/AppIntents/AppSchema/PhotosIntent/setFilter) An intent schema that applies a filter to a photo. [`setRotation`](/documentation/AppIntents/AppSchema/PhotosIntent/setRotation) An intent schema that rotates a photo. [`setSaturation`](/documentation/AppIntents/AppSchema/PhotosIntent/setSaturation) An intent schema that configures the saturation for a photo. [`setWarmth`](/documentation/AppIntents/AppSchema/PhotosIntent/setWarmth) An intent schema that configures the warmth for a photo. [`straighten`](/documentation/AppIntents/AppSchema/PhotosIntent/straighten) An intent schema that straightens a photo. [`toggleDepth`](/documentation/AppIntents/AppSchema/PhotosIntent/toggleDepth) An intent schema that toggles depth effect for a photo. [`toggleSuggestedEdits`](/documentation/AppIntents/AppSchema/PhotosIntent/toggleSuggestedEdits) An intent schema that enhances a photo. [`updateAlbum`](/documentation/AppIntents/AppSchema/PhotosIntent/updateAlbum) An intent schema that renames the provided album. [`updateAsset`](/documentation/AppIntents/AppSchema/PhotosIntent/updateAsset) An intent schema that updates an existing photo’s properties. [`updateRecognizedPerson`](/documentation/AppIntents/AppSchema/PhotosIntent/updateRecognizedPerson) An intent schema that updates the provided person with new properties. [`PhotosIntent`](/documentation/AppIntents/AppSchema/PhotosIntent) Identifies intent schemas in the photos domain. ### Content and parameter types [`album`](/documentation/AppIntents/AppSchema/PhotosEntity/album) An entity schema for an album. [`asset`](/documentation/AppIntents/AppSchema/PhotosEntity/asset) An entity schema for an asset. [`recognizedPerson`](/documentation/AppIntents/AppSchema/PhotosEntity/recognizedPerson) An entity schema for a recognized person. [`PhotosEntity`](/documentation/AppIntents/AppSchema/PhotosEntity) Identifies entity schemas in the photos domain. ### Types for static parameters [`albumType`](/documentation/AppIntents/AppSchema/PhotosEnum/albumType) An enum schema for an album type parameter. [`assetType`](/documentation/AppIntents/AppSchema/PhotosEnum/assetType) An enum schema for an asset type parameter. [`filterType`](/documentation/AppIntents/AppSchema/PhotosEnum/filterType) An enum schema for a filter type parameter. [`rotationDirection`](/documentation/AppIntents/AppSchema/PhotosEnum/rotationDirection) An enum schema for a rotation direction parameter. [`PhotosEnum`](/documentation/AppIntents/AppSchema/PhotosEnum) Identifies enum schemas in the photos domain. ### Deprecated schemas [`search`](/documentation/AppIntents/AppSchema/PhotosIntent/search) An intent schema that navigates to search results. --- 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)