Learn what's new across releases, with details of features, enhancements, and resolved issues.
GroupDocs.Comparison for Java V26.8.2Aug 28, 2026
Fixes
- PdfCompareOptions and its ComparisonDisplayMode are now available in the published jar - the PDF side-by-side and interleaved views can actually be used.
- PagesSetup is now available - PDF comparison can be restricted to a page range.
- WordCompareOptions and its ComparisonDisplayMode are now available.
- ChangeInfo.getRow(), getColumn(), getColumnHeader() are now available - cell location for spreadsheet comparison.
GroupDocs.Comparison for .NET V26.8Major versionAug 25, 2026
Features
- Improved in-memory stream processing in Side-by-Side comparison.
- Change list is now available for Side-by-Side PDF results.
Fixes
- Fixed crashes during concurrent PDF comparison.
GroupDocs.Comparison for Java V26.8.1Aug 24, 2026
Fixes
- File license activation no longer fails with IllegalAccessError (Aspose.Tasks licensing resource restored in the packaged jar).
- Public API lost to obfuscation is available again: ILogger, ConsoleLogger, CultureInfo, FontsHelper, Path, TemporaryFileManager, DefaultTemporaryFileManager, TemporaryFileManagerFactory, IgnoreChangeSensitivitySettings.
- ComparerSettings(ILogger), ComparerSettings.getLogger()/setLogger(), ComparisonLogger.setLogger(), CompareOptions.getIgnoreChangeSettings()/setIgnoreChangeSettings(), SupportedLocales.isLocaleSupported(CultureInfo) are available again.
GroupDocs.Comparison for Java V26.8Major versionAug 8, 2026
Features
- PDF side-by-side comparison view: Added a new PdfCompareOptions with DisplayMode (Inline / SideBySide / Interleaved).
- Added new SideBySideResultBuilder: Aspose side-by-side comparer, annotation grouping, page alignment (Needleman-Wunsch over per-page Jaccard similarity), blank-page insertion.
- Added Comparer.compareSideBySide() - Lightweight path comparing only images, annotations and watermarks.
- Side-by-side result: Page pairs are now merged into double-width pages; change rectangles are overlaid as SquareAnnotation borders.
- Added a new PagesSetup option - compare only a page range of a PDF.
- ChangeInfo.row / column / columnHeader is now populated for Cells comparison.
- CSV result highlighting: Inserted runs are wrapped in (...), deleted runs are wrapped in [...].
- JSON/text comparison is now rendered as an inline diff - one <div> per source line, <ins>/<del>/<span> runs in context.
- CompareOptions.compareImagesPdf / imagesInheritanceMode has been deprecated in favour of PdfCompareOptions.
- Tables are now built from Aspose's own TableAbsorber when it detects them; graphic-operator reconstruction remains the fallback.
- TextCompareResult: Regex post-processing pipeline has been removed (extractSummaryPageText, processSpans, replaceDeletedAndAddedSpans, applyStyleToElements) - the converter now emits correct markup directly.
- ComparisonPdfDocument private constructor no longer allocates a throwaway Document.
- BinaryFormatter removed: Cells StylesComparer compares raw byte[] only; ComparisonHelper.objectToByteArray() has been deleted.
- Upgraded the Aspose.Words dependency from 23.8 to 26.3 - CompositeNode.getChildNodes() need to be changed to getChildNodes(NodeType.ANY, false), Range.getFields() is now thrown.
- Upgraded the Aspose.PDF dependency from 24.10 to 26.2 - TextState.getStrikeOut() need to be changed to isStrikeOut(); stale aspose-pdf:23.4:jdk17 pins have been removed from the parent POM.
- Upgraded the Aspose.Slides dependency from 23.3 to 26.2 - ISlide.getThumbnail(Dimension) need to be changed to getImage(Dimension) / IImage.save(stream, format).
- Upgraded the Aspose.CAD dependency from 23.1 to 24.6.1 - FileFormat is now a real Java enum, DWT constant set remapped.
- Upgraded the Aspose.Imaging dependency from 23.6 to 25.12 - FileFormat.Undefined to FileFormat.Unknown.
- Upgraded the Aspose.Cells dependency from 23.6 to 26.3 - no source changes required.
- Upgraded the Diagram dependency from 23.6 to 25.10 - no source changes required.
- Upgraded the Email dependency from 23.5 to 26.1 - no source changes required.
- Upgraded the Tasks dependency from 23.1 to 25.9 - no source changes required.
- Upgraded the PSD dependency from 21.7 to 25.10 - no source changes required.
- Upgraded the BarCode dependency from 23.5 to 25.5 - no source changes required.
Fixes
- PDF footers: A line break is now also detected on an upward Y jump (content stream emitting footer text before body).
- Corrupted font subsets detected via Font.getBaseFont(); the RemoveUnusedFonts absorber now runs once per document instead of once per font.
- Excel comparison: Only string cells get character-run restyling - numeric/error cells (#DIV/0!) are no longer corrupted.
- PDF paragraph rendering rewritten: Each text segment positioned independently, with font-measured word wrap against the page width.
- Paragraph line spacing measured top-to-top (URY-URY) instead of bottom-to-top, so it no longer includes the line's own height.
- Table borders: Duplicate black grid over detected source borders removed; phantom white borders no longer drawn.
- Inherited copy/paste defect in StylesComparer.processDataMethodTag - The target branch was guarded by a sourceValue null-check.
GroupDocs.Comparison for .NET V26.7Major versionJul 31, 2026
Features
- Improved HTML output for JSON files comparison.
Fixes
- Fixed System.Drawing.Common compatibility on Linux for .NET 8 and .NET 10.
GroupDocs.Comparison for .NET V26.5Major versionMay 29, 2026
Features
- Multi-framework NuGet packaging and TFM-split packages - GroupDocs.Comparison has transitioned to a more advanced NuGet package delivery model. The main package now targets
net462, net6.0, net8.0, net10.0, replacing the previous net462, netstandard2.1 targets. In addition, to reduce the download size, dedicated per-framework NuGet packages are now published alongside the main package. When installing the platform-specific package, only the binaries matching the user's target framework are downloaded - no unused platform assemblies are included.
- PDF compare - Improved paragraph rendering accuracy in Inline mode.
- Enhanced comparison results for PDF documents with tables.
- Added support for optional disposal of passed stream in RevisionHandler.
- Improved CSV comparison result readability with text markers.
- Extended ChangeInfo with Spreadsheet Properties.
Fixes
- Fixed ArgumentOutOfRangeException when comparing PDFs with styled tables.
- Compare method throws exception for HTML output.
GroupDocs.Comparison for Java V26.5Major versionMay 25, 2026
Features
- Added Row, Column and ColumnHeader properties to ChangeInfo for spreadsheet comparison.
GroupDocs.Comparison for Python via .NET V26.5Major versionMay 13, 2026
Features
- Pure-Python wrapper rebuild - Public API is now fully introspectable from Python.
- Now ships an AGENTS.md reference inside the wheel for AI coding assistants.
- Added a new documentation page: Agents and LLM Integration (MCP server, bundled AGENTS.md, LLM-optimized docs).
- Console script 'groupdocs-comparison' is now installed with the wheel - Includes compare, info, and list-formats subcommands.
- Documentation restructure - Developer-guide/comparing-documents/ consolidates comparison-basic/ and advanced-usage/comparison/; loading and saving has been flattened.
GroupDocs.Comparison Product Family UpdateMay 1, 2026
GroupDocs.Comparison for .NET V26.4Major versionApr 29, 2026
Features
- Added the ability to produce side by side PDF comparison result.
- Added the ability to specify page ranges for PDF document comparison.
- Optimized comparison performance for PDF documents.
Fixes
- PDF with tables cause exception during processing.
- Fixed embedded fonts handling logic in PDF comparison.
GroupDocs.Comparison for Java V26.4Major versionApr 10, 2026
Fixes
- Fixed table issue that caused an exception.
GroupDocs.Comparison Product Family UpdateApr 1, 2026
GroupDocs.Comparison for Java V26.3Major versionMar 17, 2026
Features
- Word-specific options are now available in a dedicated WordCompareOptions class (extends CompareOptions). Use it when comparing Word documents to configure MarkLineBreaks, CompareBookmarks, CompareVariableProperty, CompareDocumentProperty, ShowRevisions, LeaveGaps, WordTrackChanges, RevisionAuthorName, and DisplayMode (Revisions / Highlight). The same options remain on CompareOptions but are deprecated in favor of WordCompareOptions.
- When comparing Word documents, the result Aspose Words document can be obtained via getResult().getResultDocument() even when not saving to a stream, so callers can access the comparison result document in all scenarios.
- ComparisonMailMessage now accepts an optional FileType in the constructor. Comparer and MultiComparer pass the source/target document FileType when creating email comparison instances, improving detection and behavior when comparing email files.
- Merging of Word paragraphs now handles null or whitespace-only text (returns 0 similarity), applies a word-count threshold for short strings (returns 10 when fewer than 4 words), and takes a snapshot of child nodes before moving them to avoid concurrent modification issues.
- InstanceHelper.getDocument(InputStream stream, LoadOptions loadOptions, String password) has been added to load a Word document from a stream with optional load options and password.
Fixes
- Fixed PNG comparison.
- Compare class changes - AntiHackController Default, performCheck in Comparer.
- Fixed XML declaration (Javadoc License/Metered references removed).
- Fixed build - DiagramCompareResult isTextEmpty-getChars!=null; CodeFileTest disables.
- Fixed build - words/format/Converter CalculateGaps package-private.
- Comparer - Case DIFFERENT commented out; selfComparisonCheck public for tests.
- Fixed build - ComparisonDocument constructor (Aspose.Words.Document) package-private.
- Excel comparison hanging - Cells InstanceHelper/LoadOptions, ComparisonRange mergedCells, ComparisonWorkbook worksheets.
- Sonar - CommonMethods.standartName null-check, StylesSetter.isHighlightColorSupported package-private.
- Revert - ComparisonWorkbook worksheet cache, new list per call.
- Fixed tests - MultiComparer png-UNDEFINED, else UNDEFINED-TEXT.
- Tests - Cells StylesComparer.equals, WordSeparator.runsMerger package-private.
- Build fix - ComparisonMailMessage(Document, FileType), Comparer/MultiComparer pass getFileType().
- Fixes - Email FileType passed (aligned with build fix).
- Word paragraphs merging - logic kept, merge behavior fixed.
- Fix for Word - ICompareResult.getResultDocument(), WordsCompareResult returns _wordsDocument.
GroupDocs.Comparison Product Family UpdateMar 3, 2026
GroupDocs.Comparison for .NET V26.2Major versionFeb 27, 2026
Features
- Significantly improved comparison performance for large-size Word documents.
- Added the ability to specify ChangeType directly in the GetChanges method.
- Added a new WordCompareOptions class for Word document comparison.
Fixes
- Fixed NullReference exception when comparing Word documents with WordTrackChanges = true.
- Document comparison crashes when Word document contains multi-line field code formula.
GroupDocs.Comparison Product Family UpdateFeb 3, 2026
GroupDocs.Comparison for .NET V26.1Major versionJan 29, 2026
Features
- Improved document preview functionality.
- Added dimension settings to preview functionality.
GroupDocs.Comparison Product Family UpdateJan 6, 2026