What's new in Aspose.Words for Python via .NET

[ ]

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

Aspose.Words for Python via .NET 24.1, 24.2

Aspose.Words 24.1 improves the experience around managing stroke colors, enhances OLE objects, as well as introduces a new Bibliography Sources public API.

Aspose.Words 24.2 expanded Charts API and style management. This version of Aspose.Words also introduced the capability to specify SvgSaveOptions during rendering, more flexible control loading Markdown files, and working with reference text for footnotes and endnotes.

Rendering and Printing

Stroke Color Control 24.1

The Stroke class has been extended with a set of new public properties related to managing stroke colors: fore_theme_color and back_theme_color, fore_tint_and_shade and back_tint_and_shade.

DrawingML Charts API Extension 24.2

The DrawingML Charts API continues to be expanded.

Loading and Saving Documents

Specify SvgSaveOptions During Rendering 24.2

The capability to specify SvgSaveOptions during rendering has been added using the ShapeRenderer.save and OfficeMathRenderer.save methods.

Preserve Empty Lines when Loading Markdown files 24.2

The ability to preserve empty lines when loading Markdown files has been added.


  • The capability to modify the text of the TextBox OLE control has been introduced by adding a new Text property to the new TextBoxControl class. 24.1
  • The Bibliography Sources public API was implemented through the adding a new namespace Aspose.Words.Bibliography with its new classes and enumerations, and through the adding a new bibliography property to the Document class. 24.1
  • New public properties priority, unhide_when_used, and semi_hidden for enhanced style management have been added to the Style class. 24.2
  • The functionality to retrieve the actual reference mark text for footnotes and endnotes has been enhanced with the actual_reference_mark property and the update_actual_reference_marks method. 24.2

Aspose.Words for Python via .NET 23.9, 23.10, 23.11, 23.12

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.

Aspose.Words 23.12 introduces new properties and enumerations for working with PDF and OOXML documents, as well as support for WebP images.

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 baseline_alignment 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 fit_image_to_shape 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.

Specify Page Layout when Opening PDF in Reader 23.12

The ability to specify the page layout to be used when opening a document in a PDF reader has been added through the introduction of a new page_layout property to the PdfSaveOptions class and the introduction of a new PdfPageLayout enumeration.

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 images_folder_alias 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 optimize_output settings have been implemented.

The feature to recognize hyperlinks when loading TXT documents has been implemented by adding a new detect_hyperlinks 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 emulate_rendering_to_size_on_page property and the emulate_rendering_to_size_on_page_resolution 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 insert_document_inline 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
  • 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 section_mode property. 23.11
  • A way to control how ZIP64 format extensions will be used for OOXML documents has been implemented through the new Zip64Mode property of the OoxmlSaveOptions class and the new Zip64Mode enumeration. 23.12
  • Support for WebP image has been introduced. Please note that this feature is only available for .NetStandart and .NET6+ versions. 23.12

Aspose.Words for Python via .NET 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.

Specifying the Size of Rendered Images 23.8

A new public property image_size 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 phonetic_guide 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 signature_value property. 23.7
  • The Row and Cell classes have been extended with new public members – Row.next_row, Row.previous_row, Cell.next_cell, and Cell.previous_cell. 23.7

Aspose.Words for Python via .NET 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: fore_theme_color and back_theme_color, fore_tint_and_shade and back_tint_and_shade.

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: distance_left, distance_right, distance_top, and distance_bottom.

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 epub_navigation_map_level 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 list_export_mode 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 adjust_sentence_and_word_spacing property.


  • The ability to specify the character spacing adjustment of a document has been added through the justification_mode 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 include_textboxes_footnotes_endnotes_in_stat 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 automatically_update property 23.2
  • The ability to determine whether Run is a phonetic guide run has been added using the is_phonetic_guide 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 Python via .NET 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: 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

New Border Rendering Properties 22.12

New public properties theme_color and tint_and_shade 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 auto_numbering_detection 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 ignore_structured_document_tags 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
  • 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 Python via .NET 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, macOS, 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 shadow_format 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 Compliant 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

Aspose.Words for Python via .NET 22.3, 22.4

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 Features

Starting with Aspose.Words 22.4, support for Python 3.10 has been added.

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.

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 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_A4. 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.

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.

Loading and Saving Documents

Controlling Style Behavior When Loading a Document

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

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 export_shapes_as_svg property.

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.


  • The ability to get OOXML of a content control and save it to string has been introduced.
  • Recognition of non-standard footnotes in PDF documents on import has been added.
  • An ability to get custom field data that is associated with the field has been added.
  • 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.

See Also