Aspose.Words FOSS for Java — Frequently Asked Questions

Aspose.Words FOSS for Java — Frequently Asked Questions

Licensing and Open Source

What is the licensing model?

Aspose.Words FOSS for Java is open-source software released under the MIT license. The license text is the LICENSE file in the GitHub repository, and the same file is inside the published jar.

Can I use it in commercial products?

The MIT license permits it. Read the license text and the third-party notices in THIRD-PARTY-NOTICES.md for the terms of the libraries the package contains. The jar includes a Bouncy Castle FIPS jar that is not the certified FIPS 140 module.

Is this the same as the commercial Aspose.Words for Java?

No. It is a reduced edition that uses the same package name, com.aspose.words, but reads and writes a smaller set of formats. The commercial product is separate and has its own license.

Installation and Requirements

How do I install it?

Add org.aspose:aspose-words-foss:26.3.0 to your Maven build. The library needs Java 8 or later; it was run on Java 8, 17 and 21.

Are there other dependencies?

Your build tool downloads ten ordinary libraries with the package. Two modified libraries, a Woodstox XML parser and a Bouncy Castle FIPS jar, are already inside it. Microsoft Word is not needed.

Format Support

Which formats can I read and write?

DOCX, DOCM, DOTX, DOTM, four Flat OPC variants, Markdown, and plain text were loaded and saved in both directions on Java 8, 17 and 21.

Which formats are rejected?

Saving as PDF, XPS, HTML, MHTML, EPUB, RTF, DOC, ODT, WordML, PNG, SVG, or TIFF throws an UnsupportedOperationException whose message starts with FOSS. Loading HTML, ODT, or RTF does the same.

API Usage

Which classes do I start with?

Document holds a whole document and DocumentBuilder writes content into it. All classes are in the com.aspose.words package.

How do I create a document and add text?

Create a Document, wrap it in a DocumentBuilder, call writeln, and save with Document.save. See How to Write Headings and Text in Java.

How do I convert between formats?

Open the file with the Document constructor and save it with a file name that has the target extension. See How to Convert Markdown to DOCX in Java.

Known Limitations

Can I create digital signatures?

No. DigitalSignatureUtil.sign throws an UnsupportedOperationException whose message starts with FOSS.

Does the reference list everything that works?

No. The API reference lists every public type. Most pages state how many of their members are marked limited or not supported, and how many were not exercised by a verified example.

See Also