---
title: kCGImageDestinationMergeMetadata
framework: imageio
role: symbol
role_heading: Global Variable
path: imageio/kcgimagedestinationmergemetadata
---

# kCGImageDestinationMergeMetadata

A Boolean value that indicates whether to merge new metadata with the image’s existing metadata.

## Declaration

```swift
let kCGImageDestinationMergeMetadata: CFString
```

## Discussion

Discussion The value of this key must be a CFBoolean value. The default value is kCFBooleanFalse. If you set this key to kCFBooleanTrue, the image destination merges the information in the kCGImageDestinationMetadata key with the image’s existing metadata. Specifically, if a tag doesn’t exist in the source, the destination adds it. If the tag exists in the source, the destination updates its value. To remove a tag, set the value of the appropriate key to kCFNull.

## See Also

### Configuring the Image Behaviors

- [kCGImageDestinationLossyCompressionQuality](imageio/kcgimagedestinationlossycompressionquality.md)
- [kCGImageDestinationBackgroundColor](imageio/kcgimagedestinationbackgroundcolor.md)
- [kCGImageDestinationDateTime](imageio/kcgimagedestinationdatetime.md)
- [kCGImageDestinationEmbedThumbnail](imageio/kcgimagedestinationembedthumbnail.md)
- [kCGImageDestinationImageMaxPixelSize](imageio/kcgimagedestinationimagemaxpixelsize.md)
- [kCGImageDestinationMetadata](imageio/kcgimagedestinationmetadata.md)
- [kCGImageDestinationOptimizeColorForSharing](imageio/kcgimagedestinationoptimizecolorforsharing.md)
- [kCGImageDestinationOrientation](imageio/kcgimagedestinationorientation.md)
- [kCGImageDestinationPreserveGainMap](imageio/kcgimagedestinationpreservegainmap.md)
- [kCGImageMetadataShouldExcludeGPS](imageio/kcgimagemetadatashouldexcludegps.md)
- [kCGImageMetadataShouldExcludeXMP](imageio/kcgimagemetadatashouldexcludexmp.md)