# Set-ImageHeifXmp

Sets the XMP metadata packet in a HEIF or HEIC file.

Project

ImagePlayground

Automate image processing, codes, metadata, charts, topology, and visual stories from PowerShell.

[View on GitHub](https://github.com/EvotecIT/ImagePlayground) [Visit Website](#) [Releases](https://github.com/EvotecIT/ImagePlayground/releases) [Changelog](#) [Get package](https://www.powershellgallery.com/packages/ImagePlayground)

Stars **102**

Forks **7**

Open issues 

Total downloads **708,853**

Release **ImagePlayground-PowerShellModule.v3.2.7**

Language: C# Updated: 2026-11-18

Command 

**Module**

`ImagePlayground`

**Inputs**

`System.String`

Sets the XMP metadata packet in a HEIF or HEIC file.

## Syntax

```
Set-ImageHeifXmp
[-FilePath] <String>
[[-FilePathOutput] <String>]
[-Xmp] <String>
[<CommonParameters>]
```

[#](#method-set-imageheifxmp-string-string-string)

Parameter set: `Xmp`

```
Set-ImageHeifXmp
[-FilePath] <String>
[[-FilePathOutput] <String>]
[-XmpPath] <String>
[<CommonParameters>]
```

[#](#method-set-imageheifxmp-string-string-string-2)

Parameter set: `XmpPath`

## Description

Requires an existing HEIF XMP item with a single writable file extent.

## Examples

### Set a HEIC XMP packet from a string

```powershell
Set-ImageHeifXmp -FilePath photo.heic -Xmp $packet
```

### Set a HEIC XMP packet from a file

```powershell
Set-ImageHeifXmp -FilePath photo.heic -XmpPath packet.xmp -FilePathOutput photo-updated.heic
```

## Parameters

**-FilePath String requiredposition: 0pipeline: True (ByValue)**

Path to the HEIF or HEIC file.

**-FilePathOutput String optionalposition: 1**

When not specified the source file is overwritten.

**-Xmp String requiredposition: 2sets: Xmp**

XMP metadata packet to write.

**-XmpPath String requiredposition: 2sets: XmpPath**

Path to a UTF-8 XMP metadata packet file.

## Common Parameters

This command supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable.

For more information, see [about_CommonParameters](https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_commonparameters).

Evotec API Reference Copyright 2026 Evotec Services

<!-- PowerForge markdown artifact sha256:8248F750AEF89BC87F332312FE9B2AEB55E3BA1E325A9ED2AA19BFBB857F2C0D -->
