---
Product: psd
Platform: java
Page Type: kb
Canonical URL: https://kb.aspose.org/psd/java/faq
Last Updated: 2026-11-19
---

# Aspose.PSD FOSS for Java — Frequently Asked Questions

FAQ about Aspose.PSD FOSS for Java: license, installation, supported files, what it cannot do, and common errors.

## Licensing & Open Source

### What is the licensing model?

Aspose.PSD FOSS for Java is MIT licensed. You can use, modify and redistribute it under the terms of the MIT license.

### Can I use it in commercial products?

Yes. The MIT license permits commercial use, modification and redistribution.

## Installation & Requirements

### How do I install Aspose.PSD FOSS for Java?

Add `org.aspose:aspose-psd-foss:26.11.0` to your Maven build. The library is published on Maven Central and has no third-party runtime dependencies.

### Which Java version does it need?

Java 11 or later. It was built for Java 11 and run on Java 11, 17 and 21. The `java.desktop` module (for `java.awt.Color`) is needed to load indexed-color documents; in a test on a runtime with only `java.base`, RGB, CMYK and PSB files loaded without it.

### Do I need Adobe Photoshop?

No. The library reads and writes PSD and PSB files itself.

## Supported Files & Features

### Which files can it open?

PSD and PSB (large document) files. RGB, CMYK and indexed-color PSD files and RGB PSB files were tried. Both types load with `PsdImage.load`, and `PsdImage` does not report which of the two a file is.

### What can I change in a document?

A layer's name, visibility and opacity. The position, clipping and blend mode key also have setters; the library does not change the layer's channel data when you change the position. Save the document with `PsdImage.save` and the changes are in the file when you load it again.

### Does it render or convert PSD files?

No. The library has no rendering, export, conversion or pixel-decoding API. It loads, inspects and saves PSD and PSB structure.

## Known Limitations

### Which setters are not supported?

`PsdImage.setActiveLayer`, `PsdImage.setImageResources`, `PsdImage.setGlobalLayerResources`, `PsdImage.setHasTransparencyData`, `Layer.setChannelInformation`, `Layer.setLayerMaskData` and `Layer.setLayerBlendingRangesData` always throw `UnsupportedOperationException`.

### Can I add, remove or reorder layers?

That is not a supported edit. Passing the same layer array back to `PsdImage.setLayers` is accepted, but it counts as a layer edit and the writer then rewrites every layer record.

### Can I use non-ASCII layer names?

Layer names are saved as ASCII text of at most 255 characters. A character that is not ASCII is saved as `?`, and saving an edited document rewrites the names of all layers, so do not edit documents whose layer names contain non-ASCII characters.

## Errors

### Which exception does a file that is not a PSD give?

`PsdImage.load(InputStream)` throws `PsdLoadException`. `PsdImage.load(String)` throws a `RuntimeException` that wraps it. `PsdLoadException` is not an `IOException`.

### Does a successful load prove that a file is complete?

No. The loader does not check the merged image data at the end of the file, so a file that is cut off or damaged there still loads.

### Does the library close my streams?

`load(InputStream)` does not close the stream you pass in. `save(OutputStream)` closes the stream you pass in.

## See Also

- [Aspose.PSD for Java — Enterprise Knowledge Base](https://kb.aspose.com/psd/java/)