Working with metadata in PSD images

View as MarkdownMarkdown

Set up your AI agent

Give your coding agent live access to the GroupDocs documentation and API reference through the GroupDocs Docs MCP server — no install, no API key. Learn more

claude mcp add --transport http groupdocs-docs https://docs.groupdocs.com/mcp

Also process documents locally

The GroupDocs.Metadata MCP server lets your agent work with files on your machine; they are never uploaded. It needs the .NET 10 SDK or Docker.

claude mcp add groupdocs-metadata -- dnx GroupDocs.Metadata.Mcp --yes
Folders, licensing and more →

Reading Photoshop Metadata properties

The GroupDocs Metadata API allows the user to read Adobe Photoshop metadata associated with a PSD image. For more information on the Photoshop file format and metadata blocks please refer to the specification: https://www.adobe.com/devnet-apps/photoshop/fileformatashtml/.

The code sample below demonstrates how to extract image resource blocks (building blocks of the Photoshop file format) from a PSD image.

  1. Load a PSD file
  2. Get the root metadata package
  3. Extract the ImageResourcePackage instance and obtain a list of ImageResourceBlock objects
  4. Iterate trough the collection of resource blocks

AdvancedUsage.ManagingMetadataForSpecificFormats.Image.Psd.PsdReadImageResourceBlocks

using (Metadata metadata = new Metadata(Constants.PsdWithIrb))
{
	var root = metadata.GetRootPackage<PsdRootPackage>();
	if (root.ImageResourcePackage != null)
	{
		foreach (var block in root.ImageResourcePackage.ToList())
		{
			Console.WriteLine(block.Signature);
			Console.WriteLine(block.ID);
			Console.WriteLine(block.Name);
			Console.WriteLine(block.Data);
		}
	}
}

Reading the image header and information about PSD layers

The GroupDocs.Metadata API also supports extracting some other format-specific information from PSD images.

The following are the steps to read the header of a PSD file and extract information about the PSD layers.

  1. Load a PSD image
  2. Get the root metadata package
  3. Extract  the native metadata package using the PsdRootPackage.PsdPackage property
  4. Read the PSD header and layer information

AdvancedUsage.ManagingMetadataForSpecificFormats.Image.Psd.PsdReadNativeMetadataProperties

using (Metadata metadata = new Metadata(Constants.PsdWithIptc))
{
	var root = metadata.GetRootPackage<PsdRootPackage>();

	Console.WriteLine(root.PsdPackage.ChannelCount);
	Console.WriteLine(root.PsdPackage.ColorMode);
	Console.WriteLine(root.PsdPackage.Compression);
	Console.WriteLine(root.PsdPackage.PhotoshopVersion);

	foreach (var layer in root.PsdPackage.Layers)
	{
		Console.WriteLine(layer.Name);
		Console.WriteLine(layer.BitsPerPixel);
		Console.WriteLine(layer.ChannelCount);
		Console.WriteLine(layer.Flags);
		Console.WriteLine(layer.Height);
		Console.WriteLine(layer.Width);

		// ...
	}

	// ...
}

Working with XMP metadata

GroupDocs.Metadata for .NET allows managing XMP metadata in PSD images. For more details please refer to the following guide: Working with XMP metadata.

Working with EXIF metadata

The GroupDocs.Metadata API supports handling EXIF metadata in PSD images. Please find appropriate code samples in the Working with EXIF metadata section.

Working with IPTC metadata

GroupDocs.Metadata for .NET is also able to work with IPTC metadata in PSD images. Please find more information in the Working with IPTC IIM metadata section.

More resources

GitHub examples

You may easily run the code above and see the feature in action in our GitHub examples:

PSD metadata management demo App

The PSD Metadata Editing app is available to view and edit metadata of Photoshop (PSD) images, including XMP, EXIF, IPTC, and other properties.