[Release] GroupDocs.Assembly for .NET 26.11

Dear GroupDocs users, we’re pleased to announce GroupDocs.Assembly for .NET 26.11. This release adds JSON Schema support, document preview and control of external resources, lets templates written for typed objects work on JSON, XML and CSV data, and adds a .NET Framework 4.8 build.


:warning: Please note before upgrading

External resources whose references come from data are no longer loaded by default. For example, <<image [item.PhotoUrl]>> where PhotoUrl is an http/https URI now gives an empty image. Resources referenced by the template itself and local file paths work as before. To allow trusted hosts:


LoadSaveOptions options = new LoadSaveOptions();

options.WhitelistedResources.Add("images.example.com"); // or: options.SkipExternalResources = false;

assembler.AssembleDocument("template.docx", "report.docx", options, new DataSourceInfo(data, "item"));

LoadSaveOptions.ExternalResourceHandler lets you see, allow, skip or provide every external resource.


:sparkles: What’s new

  • JSON Schema for JsonDataSource. Members declared in the schema can be used even when they are null, empty or missing in the data, and value types come from the schema.

  • Document preview. DocumentAssembler.GeneratePreview renders pages of templates and reports to PNG, JPEG or BMP, with PreviewOptions.Resolution.

  • One template for typed objects and file data. <<[o.Date.Month]>>, <<if [o.Paid]>> and Where(x => x.Paid) work on JSON, XML and CSV data without .Value or == true. GroupBy and Distinct over nested objects merge equal objects, and $id/$ref of Json.NET are supported.

  • RemoveEmptyParagraphs for spreadsheet and plain text templates.

  • Templates: images in table cells and group shapes of presentations, relative image paths resolved against the template folder, hex colors ("#FF0000") in backColor and chart color tags.

  • .NET Framework 4.8 build. Microsoft ends support for .NET Framework 4.6.2 on January 12, 2027. We will keep the net462 build for a few more months after that, so please plan the move to 4.8.

  • Engines updated to 26.10 and System.Security.Cryptography.Pkcs updated to patched versions.

:bug: Fixes

  • Metered licensing (SetMeteredKey`) works again.

  • Date-only values of JSON and CSV data no longer depend on the server time zone.

  • Text and HTML reports of ASCII-only templates keep non-Latin data (UTF-8).

  • Barcodes no longer fail when the font of their text box is not installed, e.g. on Linux.

  • No extra empty paragraph after HTML content inserted with -html.


:link: Resources

If you run into any issues or have questions after upgrading, please open a new topic and we’ll be happy to help. The full list of behaviour changes is in the “Backwards incompatible changes” section of the release notes.