Latest release (Sep 2026)

26.9.0 upgrades the bundled conversion engine from 26.3 to 26.8 and moves the wheels onto its .NET 10 build. It adds the ConversionEvents API for observing a conversion as it runs, support for XAR archives and draw.io / Mermaid diagrams, and several new load and convert options. It also fixes a long-standing defect that made every delegate-typed property impossible to assign from Python. The API is almost entirely additive; the two changes that can break existing code are listed below.

For the full release notes see GroupDocs.Conversion for Python via .NET 26.9 Release Notes.

Highlights

  • Conversion engine 26.3 → 26.8, now running on the .NET 10 build of the engine.

  • ConversionEvents — attach ordinary Python functions to observe start, progress, per-page and per-document completion, failures, and font substitution:

    from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_progress = lambda percent: print(f"{percent}%")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

  • New formats — XAR archives, draw.io diagrams, and Mermaid (.mmd) diagrams.

  • New options — CadLoadOptions.layout_scope, MarkdownOptions.image_saving_callback, EmailLoadOptions.page_layout_options, WebLoadOptions.margin_settings / orientation_settings / size_settings, ImageConvertOptions.min_resolution and cap_resolution_to_page_content, WordProcessingLoadOptions.auto_detect_rtl_direction.

  • Python 3.5 – 3.10 now actually work. The wheel has always declared >=3.5,<3.15, but 26.5.0 runs only on 3.11+: it fails to import on 3.5/3.6, and on 3.7 – 3.10 any call passing an enum argument was rejected before reaching the engine. If you are on 3.10 or earlier, this is the first release you can use.

  • Two breaking changes. The duplicate groupdocs.conversion.file_types module is removed — its 23 classes are unchanged and still live in groupdocs.conversion.filetypes, so only the import line changes. And PdfOptions.remove_pdf_acompliance is now remove_pdf_a_compliance.

  • Delegate callbacks now work — assigning a Python function to a delegate-typed property previously raised Object must implement IConvertible. This affected 17 properties, eight of which were already broken in 26.5 and 26.6.

  • Developer Guide added to the API reference, plus reference pages for groupdocs.conversion.integration.*.

Installation

pip install groupdocs-conversion-net==26.9.0

Wheel distribution

Four platform-specific wheels per release — Windows x64, Linux x64, macOS Intel, macOS Apple Silicon. pip automatically selects the right wheel for your platform.

PyPI package: https://pypi.org/project/groupdocs-conversion-net/

Feedback

If you have any questions, issues, or suggestions, please reach out through the Free Support Forum.