What's new in Aspose.Words for Java

[ ]

This page describes the most interesting new Aspose.Words features introduced in recent releases.

Aspose.Words for Java 23.9, 23.10, 23.11

Aspose.Words 23.9 expands rendering options, metafile rendering emulation, and markdown save options.

Aspose.Words 23.10 improves rendering, expands options for loading and saving documents, and allows users to merge documents in new ways.

Aspose.Words 23.11 enhances the work with revisions, XLSX format and fonts on chart legend with additional options.

Rendering and Printing

Customizing Axes Titles in DrawingML Charts 23.9

The capability to customize axis titles in DrawingML charts has been introduced by the implementation of a new public class ChartAxisTitle and Title property.

Determining the Vertical Position of Fonts within a Paragraph 23.9

It is now possible to define the vertical position of fonts within a paragraph using the new public BaselineAlignment property and the new BaselineAlignment enumeration.

Foreground Color Control 23.10

The ability to retrieve the foreground color without modifiers has been added to the Fill and Stroke classes via the BaseForeColor property.

Expanding the Functionality of Charts 23.10

The functionality of the ChartDataPointCollection, ChartSeries, and ChartFormat classes has been expanded with new methods and properties.

Automatically Adjust and Fit an Image into a Shape 23.10

A simple way to automatically adjust and fit an image within a particular shape has been provided through the new FitImageToShape method.

Default Font Formatting for DrawingML Chart Legend Entries 23.11

The ability to specify default font formatting for legend entries of DrawingML charts has been added via the Font property. This feature facilitates a more streamlined and consistent appearance for chart elements, improving the overall document aesthetics.

Loading and Saving Documents

Specifying a Folder Name to Construct Image URIs in Markdown 23.9

The MarkdownSaveOptions class has been expanded by including the ImagesFolderAlias property, which allows to specifies the name of the folder used to construct image URIs written into the Markdown document.

Reduce PDF Output Size 23.10

Various PDF rendering optimizations to reduce output size when utilizing OptimizeOutput settings have been implemented.

The feature to recognize hyperlinks when loading TXT documents has been implemented by adding a new DetectHyperlinks property.


  • Metafile rendering emulation to determine rasterization size has been implemented, specifically for WMF pen width and EMF cosmetic pen width. To achieve this, the ScaleWmfFontsToMetafileSize property was replaced with the EmulateRenderingToSizeOnPage property and the EmulateRenderingToSizeOnPageResolution property was added. 23.9
  • A simplified method for inserting one document into another document at the current cursor position has been introduced using the InsertDocumentInline method. 23.10
  • The ability to access and modify style properties has been added through the introduction of the new Locked property. 23.10
  • A generic type parameter has been added to the methods of the CompositeNode class. 23.10
  • A way to control when a certain revision should be accepted/rejected or not has been implemented by using the Accept and Reject methods. This enhancement grants users finer control over the revision process. 23.11
  • The ability to write all sections of a document onto the same XLSX worksheet has been provided through the new XlsxSectionMode enumeration type and the new SectionMode property. 23.11

Aspose.Words for Java 23.5, 23.6, 23.7, 23.8

Aspose.Words 23.5 enhances the ability to work with chart series data and the ability to work with ODT documents, as well as improve headers/footers and their text wrapping.

Aspose.Words 23.6 expands rendering options, adds a new export format, improves LINQ reporting and LowCode tools.

Aspose.Words 23.7 enhances reporting capabilities, adds a new export format, and introduces changes to working with tables and digital signatures.

Aspose.Words 23.8 expands the capabilities of different formats, improves rendering, and adds new options for working with fields.

Supported Formats

  • Starting with version 23.6, it is possible to save a document in XLSX format. Now you can convert your documents to Excel format. 23.6

  • Starting with version 23.7, it is possible to save a document page or shape in EPS format. 23.7

  • New Format Features

    • The functionality to automatically generate Table of Contents (TOC) for MOBI documents has been introduced. 23.8
    • The PdfEncryptionDetails constructor has been expanded with PdfPermissions. 23.8
    • Shaping of vertical text for EMF metafiles has been implemented. 23.8


Get and Modify Chart Series Data 23.5

The feature to get and modify chart series data was provided by adding:

Support for Advanced Typography 23.6

Support for Advanced Typography in WMF, EMF and EMF+ rendering has been added.

Colored Content on the Page 23.6

The public property PageInfo.Colored, indicating whether the page is colored or not, has been added.

Formatting for Chart Data Labels 23.6

The ability to set fill, stroke, and callout formatting for chart data labels has been implemented.

Mail Merge and Reporting

Dynamic HTML Insertion for LINQ Reporting Engine 23.6

A new way of dynamic HTML insertion for LINQ Reporting Engine has been added.

Mustache Tags Support 23.7

Mustache tags are now supported in the MailMerge.GetRegionsHierarchy and MailMerge.GetFieldNamesForRegion methods.

LINQ Reporting Engine Template Syntax Updates 23.7

The LINQ Reporting Engine template syntax now supports the ElementAt and ElementAtOrDefault extension methods.

Specifying the Size of Rendered Images 23.8

A new public property ImageSize for specifying the size of rendered images in pixel has been introduced.

Preserve Whitespaces for JSON String Values – LINQ 23.8

An option has been added to the LINQ Reporting Engine to preserve whitespaces for JSON string values.

LowCode 23.6

New LowCode methods intended to merge different types of documents into a single output document have been added.


  • Support for text wrapping in headers/footers has been implemented. 23.5
  • The ability to remove digital signatures from ODT documents has been added through the RemoveAllSignatures method. 23.5
  • The public property PhoneticGuide to obtain the base and ruby text of the phonetic guide Run has been added. 23.5
  • The ability to retrieve a digital signature value from a digitally signed document as a byte array has been added by introducing a new SignatureValue property. 23.7
  • The Row and Cell classes have been extended with new public members – Row.NextRow, Row.PreviousRow, Cell.NextCell, and Cell.PreviousCell. 23.7
  • Support for CITATION and BIBLIOGRAPHY fields has been added. 23.8

Aspose.Words for Java 23.1, 23.2, 23.3, 23.4

Aspose.Words 23.1 improves the performance of raster operation emulation, as well as enhances document exporting and rendering quality.

Aspose.Words 23.2 introduces saving documents in the MOBI format, improves chart rendering, and makes notable changes to document appearance details.

Aspose.Words 23.3 enhances the documents import and saving with new properties, and also improves the quality of work with background and foreground color and radial gradient.

Aspose.Words 23.4 improves the calculation of some parameters and the positioning of the table and surrounding text.

Performance Improvements

Emulation of Raster Operations 23.1

Performance and quality of emulation of raster operations with metafiles have been significantly improved.

Supported Formats

Export to MOBI 23.2

Starting with version 23.2, it is possible to save a document in MOBI format (also called PRC, AZW – Amazon Kindle’s own e-book file format). Now you can not only load MOBI documents, but also export your files to MOBI format.


Work with Shading Theme Colors 23.1

The ability to work with shading theme colors has been implemented.

Support of R-squared Coefficient in DML Charts 23.1

Support of R-squared coefficient in DML chart trendline labels when rendering has been added.

Chart Rendering Improvements 23.2

Since 23.2 the chart rendering has been significantly improved.

Background and Foreground Color Control 23.3

The Fill class has been extended with a set of new public properties related to background and foreground colors: ForeThemeColor and BackThemeColor, ForeTintAndShade and BackTintAndShade.

Radial Gradients with the SkiaSharp Native Shader 23.3

Rendering of radial gradients with the SkiaSharp native shader for .NET Standard has been implemented.

Distance Between the Table and Surrounding Text 23.4

The ability to set the distance between the table and surrounding text has been added by introducing new properties to the Table class: DistanceLeft, DistanceRight, DistanceTop, and DistanceBottom.

Loading and Saving Documents

Generate TOC for AZW3 Documents 23.1

The ability to generate TOC (table of contents) for AZW3 documents has been added through the use of the EpubNavigationMapLevel property.

Exporting List Items to Markdown 23.1

A way to control the export of list items to Markdown format has been provided by adding the ListExportMode property to the MarkdownSaveOptions class.

Document Saving Progress Notifications 23.3

Saving progress notifications for MOBI and AZW3 formats has been implemented.

Sentence and Word Spacing Adjustment 23.3

The ability to specify whether to adjust sentence and word spacing automatically upon document import has been added by introducing the AdjustSentenceAndWordSpacing property.


  • The ability to specify the character spacing adjustment of a document has been added through the JustificationMode property implementation 23.2
  • The way to instruct Aspose.Words whether to include textboxes, footnotes, and endnotes in word count statistics has been provided by adding the IncludeTextboxesFootnotesEndnotesInStat property 23.2
  • A new option for a document style, which allows specifying whether the style is automatically redefined based on the appropriate value, has been introduced through the AutomaticallyUpdate property 23.2
  • The ability to determine whether Run is a phonetic guide run has been added using the IsPhoneticGuide property 23.4
  • A simple way to work with series and axes of combo charts has been implemented by introducing the ChartAxisCollection class and adding the Chart.Axes property 23.4
  • New public properties connected to the shape relative positioning and sizing have been added to the Shape class 23.4
  • Accuracy and performance of color brightness calculation for automatic text color resolution has been improved in accordance with the latest versions of Microsoft Word 23.4

Aspose.Words for Java 22.9, 22.10, 22.11, 22.12

Aspose.Words 22.9 expands options for loading and saving documents and improved interaction with some other options.

Aspose.Words 22.10 improves find and replace options, enhances OLE objects, and expands list functionality.

Aspose.Words 22.11 expands its functionality with new options for more convenient work with already familiar objects: fields, printing, OLE and structured document tags.

Aspose.Words 22.12 enhances rendering capabilities and introduces options for working with margins when loading/saving a document.

Performance Improvements 22.12

An optimization that significantly reduces the depth of graphics state nesting when rendering to PDF to maintain specification compliance has been introduced.

Rendering and Printing

Printing Non-colored Pages on a Color Printer 22.11

A custom colored/grayscale print mode has been implemented by adding a new GrayscaleAuto value to the ColorPrintMode enumeration.

A new print property allows users to control how non-colored pages are printed if the device supports color printing. This feature can be useful if users want to automatically print non-colored pages using only grayscale printing mode.

New Border Rendering Properties 22.12

New public properties ThemeColor and TintAndShade have been introduced.

Linear Trendline Formula for DrawingML Rendering 22.12

Linear trendline formula rendering for DrawingML charts has been implemented.

Font Fallback Settings for Google Noto Fonts 22.12

The predefined font fallback settings for Google Noto fonts have been updated.

Loading and Saving Documents

The ability to cache header/footer shapes to reduce the size of the output PDF file has been implemented by adding a new CacheHeaderFooterShapes property.

Automatic Numbering Detection when Loading a Document 22.9

The ability to specify the AutoNumberingDetection property upon text loading has been implemented through an extended of the TxtLoadOptions class.

Specifying a Particular Margin Type 22.12

The ability to specify a particular Margin type for the given section has been implemented.

Search and Compare 22.10

The ability to ignore StructuredDocumentTag upon find and replace options has been implemented by adding a new IgnoreStructuredDocumentTags property to the FindReplaceOptions class.


  • A new feature to get FieldEQ as an OfficeMath has been added. 22.9
  • The creation of structured document tags of Group type at the Row level was allowed. 22.9
  • OLE objects and controls are now treated as metafile images when converting a document to HTML. 22.10
  • A new feature to check that a particular list was created from the same template as the compared list has been added by introducing a new HasSameTemplate method into the List class. 22.10
  • The ability to create new structured document tags of the Citation type has been added. 22.11
  • The ability to track the field updating progress has been provided. 22.11
  • A new EmbedAttachments property that allows users to embed OLE attachments from a source document into the output PDF document has been introduced. 22.11

Aspose.Words for Java 22.5, 22.6, 22.7, 22.8

Aspose.Words 22.5 introduces support for new loading formats and a new print page size, as well as improves some rendering options.

Aspose.Words 22.6 expands the possibilities of converting PDF to other formats, as well as improve work with DrawingML and solid text fill effect.

Aspose.Words 22.7 enhances the possibilities of working with rendering features, and also adds new features for working with HTML import and export to PDF.

Aspose.Words 22.8 introduces a new export format and improves various rendering algorithms.

The API is enhanced for more flexible and convenient development.

Supported Formats

  • Support for loading EPUB and XML documents has been introduced by adding new values to the LoadFormat enumeration. Starting from version 22.5, it is possible to load EPUB and XML documents into Aspose.Words document model and convert them to any supported formats. 22.5
  • Starting from version 22.8, it is possible to save a document in AZW3 format – Amazon Kindle’s proprietary e-book file format (KF8 is another name for the format). Now you can not only load AZW3 documents, but also export your files to AZW3 format, which is essentially a compiled EPUB. 22.8

Rendering and Printing

New Printing Size 22.5

Support for the “Envelope No. 10” print page size has been added by introducing a new value to the PaperSize enumeration.

Rendering MathML Formulas 22.5

The rendering of a border box around MathML formulas and font detection when rendering characters for such formulas has been improved.

DML Chart Improvements 22.6

DrawingML charts public API has been extended to support gradient, texture, and pattern fills.

Glyph Outlines Parsing for OpenType 22.7

Aspose.Words own glyph outlines parsing for OpenType (CFF) fonts has been implemented.

Previously, glyph parsing for OpenType (CFF) fonts was performed via GDI+. So now it works in cases where GDI+ is not available – Java, .NET Standard platforms, Linux OS, etc. Glyph outlines parsing is required in specific cases like WordArt, text effects, some Office Math features, and others.

Set Shape Shadow Formatting 22.7

The ability to set the shadow formatting of the shape object has been provided by adding a new ShadowFormat property.

Support for Cell Spacing in Tables 22.8

The layout engine is now significantly improved: a very complex cell spacing mechanism in tables has been implemented.

Font Substitution for Symbols 22.8

Font substitution for symbols has been improved.

Chart Axis Label Rotation Algorithm 22.8

The rotation algorithm of chart axis labels has been improved.

Loading and Saving Documents

Load and Convert PDF to Fixed-page Format without Layout Model 22.6

The ability to load and convert PDF documents to fixed page formats with high fidelity and performance has been implemented.

New HTML Import Mode 22.7

A new HTML import mode for block-level elements has been introduced by adding a new value to the HtmlInsertOptions enumeration.

Convert to PDF/UA-1 CSSompliant with WCAG 2.0 22.7

Support for converting a document to PDF/UA-1 format, compliant with WCAG 2.0, has been added.

So, if the customer has an accessible Word document and converts it to PDF/UA-1 via Aspose.Words mentioning the conversion specifics, then the output will be WCAG 2.0 compatible.

WCAG or Web Content Accessibility Guidelines is a set of guidelines developed by W3C in collaboration with individuals and organizations all over the world. Now with Aspose.Words you can convert your document to the output PDF/UA-1 format, which is suitable to build WCAG 2.0 compliant PDF documents.

It is worth noting that WCAG 2.0 has two additional requirements that are not specified in the PDF/UA-1 specification:

  • contrast requirements
  • requirements for tagging multimedia content

But both requirements are not relevant to our case of converting from Word to PDF.


  • Exception of inheriting the solid text fill effect that mimics MS Word behavior has been implemented. 22.6
  • Support of the DATABASE fields has been added. Using this type of field, you can, for example, show the results of a database query in a Microsoft Word table. 22.7

Aspose.Words for Java 22.1, 22.2, 22.3, 22.4

Aspose.Words 22.1 improves rendering options, as well as loading and saving documents.

Aspose.Words 22.2 introduces a new load format and new options for exporting documents. It also contains a major update for tables and some changes for working with fields.

Aspose.Words 22.3 expands the possibilities of working with PDF and TXT formats and improves the work of some existing algorithms and engines.

Aspose.Words 22.4 enhances PDF capabilities – now you can save a file in PDF/A-4 format and get a number of other improvements in PDF output. At the same time, Aspose.Words 22.4 provides additional abilities to work with DML charts, read the Photoshop metadata, and import HTML block-level elements.

The API is enhanced for more flexible and convenient development.

Supported Formats

Loading a document in AZW3 format (KF8 is another name for the format) has been added. Now you can load an AZW3 document and convert it to any other supported formats.


Rendering to PDF with PDF/UA-1 Compliance

Rendering into PDF with PDF/UA-1 compliance has been implemented by adding new values to the PdfCompliance enumeration – PDF_UA_1. This option assumes compliance with special requirements for document accessibility.

Rendering MathML Formulas

The rendering of operators in MathML formulas has been improved.

DML Chart Improvements

The following improvements have been made to the DML charts:

  • The DML chart axis scaling algorithm has been improved to be the same as in MS Word
  • The ability to manipulate with DrawingML chart legend entries has been provided to make our chart API more and more comprehensive
  • The ability to specify the name of an xls/xlsx file the DrawingML chart is linked to has been implemented

Rendering to PDF with PDF/A-4 Compliance

Rendering into PDF with PDF/A-4 compliance has been added by adding new values to the PdfCompliance enumeration – PDF_A_4. This option assumes revised conformance levels: regular PDF/A-4 conformance is equivalent to conformance level U of previous versions, and the level A conformance is removed.

Reading of Photoshop metadata resolution in JPEG

Reading of Photoshop metadata resolution in JPEG images has been implemented to fix an interesting issue with incorrect scaling of images upon rendering.

Loading and Saving Documents

Controlling Style Behavior When Loading a Document

A new option ForceCopyStyles has been introduced to control the behavior of conflicting styles upon document import.

Document Saving Progress Notifications

An ability to get notifications about the progress of document saving has been added through the ProgressCallback property in 22.1.

In 22.2, saving progress notifications have been extended for HTML and XAML based flow formats: HTML, MHTML, Epub, XamlFlow, and XamlFlowPack.

In 22.3, saving progress notifications have been extended for TXT format.

Convert Shapes to SVG When Exporting

The ability to convert shapes to SVG images upon exporting to HTML, MHTML, or EPUB has been provided by adding the ExportShapesAsSvg property.

Export of List Numbering to PDF Logical Structure

List numbering export to PDF logical structure has been implemented.

Saving to PDF 2.0 and Improvements in PDF Output

The ability to save a document as PDF 2.0 by adding a new value to the PdfCompliance enumeration, as well as several other requested improvements to PDF output, have been introduced.

New HTML Import Mode

A new import mode for HTML block-level elements has been implemented to mimic Microsoft Word behavior.


  • An ability to get custom field data that is associated with the field has been added.
  • The latest version of Aspose.Words also included a major update that handles tables with incorrect or missing column width data in the source document.
  • The table comparing algorithm relying on deep analysis of Microsoft Word comparison mechanism has been improved.
  • The comments syntax in LINQ Reporting engine has been provided.

Aspose.Words for Java 21.9, 21.10, 21.11, 21.12

Aspose.Words 21.9 expands the list-level formatting control.

Aspose.Words 21.10 enhances rendering options, improves find and replace options, and expands Mail Merge and Structure Document Tag functionality.

Aspose.Words 21.11 expands loadings and saving functionality, improves find and replace option and working with PDF.

Aspose.Words 21.12 introduces additional options for working with Latin text and fonts to improve appearance and performance, and expands the ability to work with content control and footnotes.

The API is enhanced for more flexible and convenient development.

Performance Improvements

Loading a previously saved font search cache to speed up the font cache initialization process upon rendering has been implemented. Now your solutions will work even faster.


Working with gradient fills and gradient stops

New public methods and properties to work with gradient fills and gradient stops have been added to satisfy the brightest ideas when developing your documents.

Attachment Pane in Output PDF Documents

A new option UseAttachments has been implemented to display the attachment pane in output PDF documents.

Allow Latin Text to Wrap in the Middle of a Word

Support for the “Allow Latin text to wrap in the middle of a word” feature has been implemented to make our Latin support even better upon rendering.

Search and Compare

  • A new option IgnoreFootnotes to ignore footnotes during the find and replace operation has been added.

  • A new option IgnoreFieldCodes to ignore field codes during find and replace operation has been added.


A simple way to save images as Base64 string into Markdown format has been provided through the ExportImagesAsBase64 property.

Mail Merge and Reporting

The ability to get ParentRegion through MailMergeRegionInfo, which made our MailMerge engine more tunable, has been added.


  • An ability to get the CustomNumberStyleFormat property of the ListLevel object has been added.
  • A possibility to get the string representation of the ListLevel object for a specified index using the GetEffectiveValue method has been added.
  • An intuitive capability to change the appearance of structured document tags, which actually allow embedding customer-defined semantics as well as its behavior into a document, has been introduced.
  • A new class ChmLoadOptions has been added to get more control over CHM loading.
  • The ability to get OOXML of a content control and save it to string has been introduced. To do this, the WordOpenXML property has been added to the StructuredDocumentTag and StructuredDocumentTagRangeStart classes.
  • Recognition of non-standard footnotes in PDF documents on import has been added.

See Also