Skip to main content Link Search Menu Expand Document Toggle dark mode Copy Code (external link)

Core Library Change Log

On this page

Version 9

9.7.5 - 7 October 2026

Consistent error handling in strict and lax mode. Invalid syntax is now invalid completely, and missing data is not a syntax error. The full behaviour is in the processing instructions truth table.

Behaviour Changes

  • Invalid expression syntax always throws — in strict and lax mode. This now includes an expression that compiles but is incomplete when evaluated (,), a function with the wrong number of parameters, and an invalid expression inside a repeating or conditional template (,). Lax mode previously logged these and carried on, or skipped the template.
  • A root variable that is not set (or is null) logs a single error in both modes — e.g. `` with no model. Strict mode previously threw, and lax mode logged two warnings. The value is left unset and the document continues.
  • A null part way along, or at the end of, a path is silent — model.missing.value where missing or value does not exist is just null, rather than an error. `` with no object now outputs 1. .
  • CSS var() and calc() follow the same rules — var(model.missing.value, red) uses the default if there is no model, missing or value; without a default the property is left unset, with an error logged only if there is no model. Invalid css expressions are validated and raised when the css is parsed.
  • Document.CreateParserSettings() and CreateParserSettingsAsync() now default to Lax — matching Document.ParseDocument() and the render options. A parser-mode processing instruction still overrides the default.
  • Expressions supplied as data to eval() are still treated as any other evaluation failure (strict throws, lax logs a warning), as they are not part of the template.

New Features

  • int() function — a short name for integer(), alongside long(), double() and bool().

Fixes

  • Function documentation corrected — the reference now uses the names the engine registers: monthOf (not monthOfYear), deg, rad, isMatch, matches and swap (not degrees, radians, regexIsMatch, regexMatches and regexSwap). The examples in the expressions crib sheet that used monthofyear never evaluated, and have been corrected.

9.7.4.4 - 1 October 2026

Fixes

  • colspan cell content squeezed into one column — the content of a cell spanning several columns (paragraphs, text) was being laid out at the width of its starting column rather than the full spanned width. The cell’s outer box was already the correct size, but the content inside was not.
  • <figure> no longer forces its content to be unsplittable — a <figure> was set so it could never split across a page, which was meant to keep an image and its caption together but also applied to a long table wrapped in a figure. A table too tall to fit on one page now splits normally instead of failing with an InvalidOperationException.

9.7.4.3 - 1 October 2026

Fixes

  • colspan cells losing a colgroup column’s width — where a <col> column is never occupied by a single-column cell in any row (for example a three-column percentage colgroup where every row spans the middle column), its width was dropped and every colspan cell crossing it lost that width. The width is now resolved through the normal style pipeline, so percentage, em, rem, viewport units, calc() and var() all work on <col> widths.

9.7.4.2 - 10 September 2026

Fixes

  • Image aspect-ratio with a resolved width and height — max-width, max-height, min-width and min-height are now honoured, and the other dimension re-derived from aspect-ratio, when both dimensions were already resolved (for example an <img> sized only by its width/height attributes inside a percentage-width <figure>). Previously that combination skipped clamping and the aspect ratio entirely.
  • <hr> is a real box-model element — it is now a block with border-*, background-color, height, width and margin, instead of a stroked diagonal-line path. Resets such as border: none; height: 4pt; background-color: #369; render a coloured bar instead of a diagonal line, and a bare <hr> keeps its default 1pt solid black bottom border.
  • JSON values from a dictionary — a JsonElement or JToken stored as a value in a Dictionary<string, object> parameter is now normalized in the same way as nested JSON property access, so double() and string() work on a top-level property too.

9.7.4.1 - 8 September 2026

New Features

  • CSS Display Module 3 two-value display — e.g. block flex, inline flow-root, alongside the single-keyword values.
  • hsl() and hsla() colours — supported anywhere a colour is accepted (the CKEditor colour pickers produce them).

Fixes

  • display: table and grid with //`` — content generated by a helper is now wrapped correctly rather than dropped or leaving an empty cell, including a table row nested inside the repeated content keeping the table’s shared column grid.
  • Loose display: inline-block inside a table or grid cell is treated leniently as a block, rather than rendering blank.

9.7.4 - 4 September 2026

Fixes

  • Multi-threaded rendering — fixed a data race in font glyph registration (PDFFontWidths) that could corrupt the text of documents rendered concurrently, sometimes writing the wrong glyphs without an exception. Contributed by twofatmonkeys (PR #186). The Scryber.Core.OpenType dependency is updated to 9.7.4, which fixes a companion race in the glyph metric cache. Both are required for concurrent rendering to be safe.

9.7.3 - 4 September 2026

New Features

  • Image EXIF metadata — images now capture EXIF data (including GPS coordinates as signed decimal degrees), available in templates with the new meta(path) and meta(path, key) functions.

Fixes

  • Loose content inside display: table — a child that was not a table row or cell (for example an image inside a designer-authored <figure> with display: table) was silently dropped from the layout, and never registered as a PDF image resource.

9.7.2 - 27 August 2026

New Features

  • CSS structural pseudo-classes — :nth-child(), :nth-last-child(), :first-child, :last-child, :only-child and the -of-type equivalents, with full An+B formulas (odd, even, 2n+1, -n+3). These match across the wrappers produced by ``.
  • CSS !important — the declaration flag is now detected and takes priority in the cascade.

Fixes

  • Flex row items no longer need to be a Panel — non-container children such as bare text are wrapped so they get a block layout box.
  • Element immediately after `` — an element with no whitespace after the end of a loop could be dropped when it shared its parent’s tag name.
  • Processing instruction parser-mode is now passed down to the generated document.
  • Expression that fails to evaluate is logged as a warning, rather than an error (an expression that fails to compile is still an error).
  • Font widths — removed a shared buffer in PDFFontWidths as the first part of the multi-threading fix completed in 9.7.4.

9.7.1 - 13 August 2026

Adds fine-grained content permissions for <iframe>, replacing the old all-or-nothing style passthrough.

New Features

  • allow attribute on <iframe> — a ten-type content permissions policy (data-passthrough, style-passthrough, inner-style, inner-link, inner-navigation, inner-images, outer-html, inline-styles, inner-frames, inner-forms) controlling what is kept from embedded content and what passes through from the parent. See the allow attribute reference.
  • data-content on <iframe> now enforces allow — dynamically bound content goes through the same permission-cleaning pipeline as content loaded via src, including outer-html wrapping behaviour.
  • outer-html permission controls whether a full embedded <html>/<body> document is preserved as its own container or reduced to just its body content, now also supporting header/footer content from the embedded document.

Fixes

  • data-passthrough restored as a legacy attribute — the boolean data-passthrough="true"/"false" attribute (superseded by allow during development of this release) is back as a working, [Obsolete]-marked convenience wrapper, so existing templates keep working. It sets both data-passthrough and style-passthrough together, matching its original pre-allow behaviour. New templates should use allow to control each independently.
  • Expression binding regression — deep JSON/JObject property access on a missing intermediate property (e.g. deeparray[1].object.value where object doesn’t exist) had started silently returning a non-empty value instead of an empty result, an incidental regression introduced while building the iframe permissions work. Fixed.

9.7 - 6 August 2026

Significant new version with more general support for CSS and HTML5 features including major improvements in CSS flex, CSS grid, CSS table-xxx. Along with support for z-index, colgroup, and column-fill.

Breaking Changes

  • Image width and height attributes now only accept integer values, as intrinsic size hints. Providing a unit (pt, px, %, etc.) throws an exception. Move unit-based image sizing to style: style="width: 400pt;".

New Features

  • CSS aspect-ratio property sets a fixed width-to-height ratio on images and block elements. When only one CSS dimension is specified, the other is derived from the ratio.
  • Added <colgroup> and <col> table column elements to wire column widths, background colours, and CSS styling directly on column definitions. Also supports the span attribute to apply styling across multiple consecutive columns.
  • Added grid-template-areas and grid-area — define named layout regions and place items into them by name.
  • Added named grid lines in grid-template-columns/grid-template-rows along with reference names in grid-column and grid-row.
  • Added grid auto-fill and auto-fit in repeat() to fill a row with as many fixed-width tracks as will fit without specifying a count.
  • Added grid grid-auto-columns and grid-auto-rows to control the size of implicitly created tracks when items overflow the declared grid.
  • Added grid justify-content and align-content to distribute the grid along the inline and block axes when tracks are smaller than the container.
  • Added full support for flex-basis, flex-direction, flex-flow, flex-grow, flex-shrink so flex containers now output as expected.
  • Added flex align-items in column direction so flex containers now correctly support cross-axis alignment.
  • CSS var() and calc() in flex/grid now work inside all CSS property values.
  • column-fill support for reflowing content in a multi-column layout to match heights in each. Default is still auto to match existing behaviour on templates.
  • z-index support for positioned content, so order of rendering can be controlled.
  • Added FindMatch() to component that can execute a JQuery’esque search for any Components that match that query, returning a collection of results, and queries can be chained.

Fixes

  • SVG image min/max sizing — min-width, max-width, min-height, max-height are now honoured for SVG images, with correct aspect-ratio preservation when only one axis is constrained.
  • SVG images clipping — unsized SVG images (no viewBox, no declared dimensions) no longer clipped to 300×150 regardless of the <img> box size.
  • Page breaks — a page-break-after: always followed immediately by page-break-before: always no longer inserts a redundant blank page between sections.
  • Grid page overflow — continuation row gaps are stripped and height corrections propagate correctly across page breaks.
  • Grid row-span cell height and row-gap border rendering fixed for multi-row spanning cells.
  • Flex wrap — various fixes for inter-row padding/margin/border.
  • List overflow — fixed infinite layout loop when an <ol>/<ul> overflows with zero visible contents.
  • Anonymous table wrapping — anonymous <tr>/<td> insertion no longer absorbs insignificant whitespace nodes, preventing empty cells.
  • Font glyph table — PDFFontDefinition now outputs the correct glyph offset count in the bfrange CMap table.
  • Infinite pagination — fixed a case where a header or footer that itself requested a page break caused the layout engine to loop indefinitely.

9.6-beta - 15 May 2026

  • NEW: Added support for display flex layout.
  • NEW: Added support for display grid layout
  • NEW: Added support for table-x layout
  • NEW: Added support for z-index rendering
  • NEW: Added support for column balancing
  • Fixed an issue with with multiple returns

9.5 - 6 May 2026

Breaking change - removed support for .NET Standard.

As an upgrade to SixLabors.Imaging library 3+ we have now dropped support for dotnet standard. This will hopefully not cause issues, but reach out if so.

  • Added support for webp image formats, both lossy and lossless including alpha

9.3 - 21 April 2026

  • CSS initial support on generic tags for
    • display: flex,
    • display: grid,
    • display: table-xxx.
  • CSS support for table cell rowspan across multiple rows with overflow and stepping calculation.
  • CSS support for border radius on individual columns ()
  • CSS support for setting individual variable values from the document.Params item collections
  • CSS Support for column rule styles on multi-column layouts.

  • CSS support for contain sizing on background images.

  • Code fix pre-pended whitespace on soft return lines with bindings.
  • Code fixes for labeled page sizes and falling back to previous sizes afterwards.
  • Code fixes for sizing and positioning of referenced (rather than inline) SVG images, via the img tag (including %age widths)

  • Code throws an exception when a font is not matched, when running in strict mode.

  • Configuration loading improved for console and forms applications.
  • Configuration section added for Expressions, that supports custom functions.
  • Configuration of custom image factories improved to support async remote loading.

9.2.0.3 - 22 Jan 2026

  • Fixed styling issue when components are hidden using css.

9.2.0.2 - 13 Nov 2025

  • Fixed repeating raster background images with cover size.
  • Added support for repeating SVG background images from Data urls

9.2.0.0 - 6 Nov 2025

  • Public release with all added features from the betas. Too many to list.
  • The documentation is here learning
  • And the refererence section here refererence

Version 9 pre-release

9.1.2-rc.5/6 - 4 Nov 2025

  • Couple of fixes for overflowing tables in a kept together parent
  • SVG font-weight bold and light are now supported
  • Fixed an issue with the reverse function.

9.1.2-rc.4 - 3 Nov 2025

  • Working modification of PDFs and templates using framesets and frames
  • Support for SVG background images with opacity.

9.1.0.7-beta - 22 Sept 2025

  • First release of framesets for trimming and merging documents.
  • Hiding variables that do not have any content.

9.0.0.1-rc.3 - 26 May 2025

  • Added extra html entity (&…;) values to match available sources.

9.0.0.1-rc.2 - 22 May 2025

  • Fixes for template parsing
  • Added data-content to the template element
  • Minor fixes and unit test updates.
  • Second release candidate.

9.0.0.1-rc.1 - 13 May 2025

  • Minor fixes for layout.
  • First release candidate.

9.0.0.1-beta - 6 May 2025

  • Fixed a minor layout issue with multiple footer elements

9.0.0.0-beta - 6 May 2025

  • Completely updated version for .NET 9.0 with support for html, css, svg and binding.
  • WASM compatible package with remote asset and content requests.

NOTE: If upgrading, PLEASE CHECK THE OUTPUT of your documents before releasing.

Version 8

8.0.0.2-beta - 19 March 2025

Added a fix for the rounding of expression results on decimal and double values when the results are very small.

8.0.0.1-beta - 17 Feb 2025

Updated to net8.0 sdk and dependancies updated to the latest stable versions.

Legacy Versions

Version 6

6.0.5.0-beta

Updated to net8.0 sdk and dependencies updated to latest version.

6.0.4.0-beta

Big updates to whitespace handling, support for &nbsp; and hyphens in line breaks.

6.0.3.2-beta

Fix for prioritising parsing unit values in invariant culture on OS’s set to non-invariant culture.

6.0.3.1-beta

Minor fix for transforming svg components (that do not have explict position values).

6.0.3.0-beta

Added fixes for parsing (x)html content on systems not running the english culture. All numeric values are expected to be in english decimal notation - e.g. 1,0234.56 for values in CSS, styles, svg etc. Unit testing works for non-english. May be a couple of values / options missed but hoping not. Added the AddRange option to top level component wrapping lists - (Rows, Cells, Items, etc.) that accepts an IEnumerable<InnerType> instance.

6.0.2.1-beta

Added fix for large inline images. Tested SaveAsPDFAsync.

6.0.1.1-alfa

Support for SaveAsPDFTimer, to check for asyncronous execution in a single threaded application - blazor (or windows forms?), using asyncronous loading of http requests for css images, fonts etc).

6.0.1.0-beta

We now support html - in many of its flavours, through the HTMLAgilityPack

Added parsing non-formal html documents and components from local and remote files (using the ParseHtml and ParseHtmlDocument on the Document class) Added the data-content and data-content-type attributes to visual components so that html and xhtml content can be data bound into pages. Added support for the hyphens css property and it’s use in hypenating long text.

6.0.0.16-beta

Some Big additions and fixes

Added support for the css counters (reset, increment and the counter(s) functions) Added support for css content properties Added support for css ::before and ::after selectors Added support for relative units in styles e.g. 30% and 0.5em - not supported in calc() with multiple units e.g calc(50% - 5px) will not work.

A lot of layout tests to get everything working - precisely.

6.0.0.14-beta

Added support for transformations including css transform property.

6.0.0.12-beta

Changed the reference for ImageSharp to the 2.1.3 Nuget package, rather than the dll. Checks added for support on thread culture in dates and numbers.

6.0.0.10-beta

Added support for Netwtonsoft.Json and the System.Text.Json objects in binding expressions and templates too. Along with adding SoryBy, MaxOf, EachOf, SelectWhere collection functions.

6.0.0.5-beta

Updated to the .net 6.0 sdk, now with support for running as a web assembly with asyncronous loads of stylesheets, images and fonts. Some TTC and TTF font files do not render glyfs correctly, but working for many fonts.

Version 5

5.1.0.2-beta

A major update that now fully supports expressions in attributes, css var and clac along with text, using the handlebars notation - {{…}} This includes support for simple mathematical expressions from the document variables as welll as functions such as ‘concat’, ‘if(value, ‘true’, ‘false’)’ or ‘index() + model.property’

5.0.7

Adding support for the float left and right within blocks along with css linear and radial gradients

5.0.6.3

Fixes an issue with some TTF fonts on Windows (specifically azure) to look for the best character mapping table, and multi-span text not flowing well due to some changes to try and get float working.

5.0.6

The April release is a bit of a catch up and fix with updates for:

  • Supporting parsed JSON objects in binding - along with std types and dynamic objects.
  • margin:value is applied to all margins even if explicit left, right etc. has been previously applied.
  • Conformance is now carried through to templates, so errors are not indavertantly raised inside the template.
  • Missing background images will not raise an error.
  • Support for data images (src=’data:image/..’) within content - thanks Dan Rusu!
  • Images are not duplicated within the output for the same source.

5.0.5

Multiple enhancements including

  • Embed and iFrame support.
  • Binding speed improvements for longer documents.
  • Support for border-left, border-right, etc
  • Support for encryption and restrictions
  • Support for base href in template files.
  • Classes and styles on templates are supported.
  • Added em, strong, strike, del, ins elements
  • Html column width and break inside
  • CSS and HTML Logging
  • Fixed application of multiple styles with the same word inside
  • Allow missing images on the document is now supported.
  • Contain fill style for background images.