NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #1955 most downloaded on crates.io
HTML escaping, extracted from Askama
Latest stable
0.16.1
Last release 2 months ago
04 Sep 2026
Ships unpredictably
gaps range from 5 weeks to 3.1 years
Most releases are documented
notes for 12 of 17 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
18 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
docs: explain how to install by enabling feature specific for each framework by @pinage404 in https://github.com/askama-rs/askama/pull/742
let/set block type by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/760Full Changelog: https://github.com/askama-rs/askama/compare/v0.16.0...v0.16.1
This new release increases compatibility with jinja language, add support for more rust expressions in the templates. Take a look at the book for the
Your coding agent can read these notes before it upgrades. Set up the MCP server →
This new release increases compatibility with jinja language, add support for more rust expressions in the templates. Take a look at the book for the migration guide.
(❗ = breaking change)
❗Add support for let blocks by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/697
Implement compound assignments (e.g. {% mut a += 1 %}) by @Kijewski in https://github.com/askama-rs/askama/pull/685
Add support for tuple, array and slice in type generics by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/721
Add support for macro args type annotations by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/722
Add support for caller() in variable declaration by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/724
Add glob support for dirs in config file by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/731
size_hint is collected by @Kijewski in https://github.com/askama-rs/askama/pull/700dyn instead of plain generic bounds by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/726std::path::absolute to avoid symlinking template paths by @kaepr in https://github.com/askama-rs/askama/pull/720config by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/732Template trait methods can return Err by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/730Ty generics by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/723complex-expression benchmark by @Kijewski in https://github.com/askama-rs/askama/pull/691Cargo.toml files by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/696rand+rand_xoshiro dev-dependencies by @Kijewski in https://github.com/askama-rs/askama/pull/701trybuild version to 1.0.116 to enforce diagnostics width by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/718Full Changelog: https://github.com/askama-rs/askama/compare/v0.15.4...v0.16.0
Correctly handle non-ident item in block error by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/717
.clone() by @jplatte in https://github.com/askama-rs/askama/pull/716SyntaxAndCache by @jplatte in https://github.com/askama-rs/askama/pull/714winnow to 1.0 by @jplatte in https://github.com/askama-rs/askama/pull/715Full Changelog: https://github.com/askama-rs/askama/compare/v0.15.5...v0.15.6
parser: reject non-ASCII characters in byte literals by @Kijewski in https://github.com/askama-rs/askama/pull/694
Full Changelog: https://github.com/askama-rs/askama/compare/v0.15.4...v0.15.5
Improve function call handling by @Kijewski in https://github.com/askama-rs/askama/pull/684
Full Changelog: https://github.com/askama-rs/askama/compare/v0.15.3...v0.15.4
Update book links (askama.rs) by @Kijewski in https://github.com/askama-rs/askama/pull/678
Full Changelog: https://github.com/askama-rs/askama/compare/v0.15.2...v0.15.3
Correctly handle local variables in extends blocks by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/670
extends blocks by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/670#[filter_fn] by @Kijewski in https://github.com/askama-rs/askama/pull/655salvo by @Kijewski in https://github.com/askama-rs/askama/pull/659Upgrading to new versions chapter in the askama book by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/665extends by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/666where bounds in #[filter_fn] by @Kijewski in https://github.com/askama-rs/askama/pull/672filters chapter by @Tirka in https://github.com/askama-rs/askama/pull/673filters chapter examples (by making us of defined_or filter) by @Tirka in https://github.com/askama-rs/askama/pull/675Full Changelog: https://github.com/askama-rs/askama/compare/v0.15.1...v0.15.2
Fix broken intra-doc links by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/645
call_site for code generated by the derive proc-macro by @sehnryr in https://github.com/askama-rs/askama/pull/647Full Changelog: https://github.com/askama-rs/askama/compare/v0.15.0...v0.15.1
Implement Values on tuple by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/391
Values on tuple by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/391first and blank arguments for |indent by @Kijewski in https://github.com/askama-rs/askama/pull/401unique filter by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/405askama_derive accidentally exposed as a feature by @Kijewski in https://github.com/askama-rs/askama/pull/384CARGO_MANIFEST_DIR part of ConfigKey by @strickczq in https://github.com/askama-rs/askama/pull/395unique filter implementation by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/417|titlecase as alias for |title by @Kijewski in https://github.com/askama-rs/askama/pull/416FastWritable by @Kijewski in https://github.com/askama-rs/askama/pull/407FastWritable into askama root by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/411Full Changelog: https://github.com/askama-rs/askama/compare/v0.13.0...v0.14.0
Update ui tests for rust 1.84, and deprecations in winnow 0.6.24 by @Kijewski in https://github.com/askama-rs/askama/pull/312
With this release, the fork rinja got merged back into the main project. Please have a look at our blog post for more information about the split and the merge.
This release (v0.13.0), when compared to the last stable askama release (v0.12.1), consists of:
rinja into askama by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/353Major added and improved features:
enum variants by @Kijewski in https://github.com/askama-rs/askama/pull/255filesizeformat filter requirements by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/216blocks by @Kijewski in https://github.com/askama-rs/askama/pull/337~ by @Kijewski in https://github.com/askama-rs/askama/pull/236#![no_std] compatible by @Kijewski in https://github.com/askama-rs/askama/pull/286derive optional by @Kijewski in https://github.com/askama-rs/askama/pull/342More added and improved features:
FastWritable propagate custom errors by @Kijewski in https://github.com/askama-rs/askama/pull/217PrimitiveType for non-zero integers by @Kijewski in https://github.com/askama-rs/askama/pull/220AsIndent for NonZeroUsize and Wrapping<usize> by @Kijewski in https://github.com/askama-rs/askama/pull/221HtmlSafe for all reference wrappers by @Kijewski in https://github.com/askama-rs/askama/pull/219extends by @Kijewski in https://github.com/askama-rs/askama/pull/241_ by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/244std::num::Saturating is stable since rust 1.74 by @Kijewski in https://github.com/askama-rs/askama/pull/270Errors a bit easier by @Kijewski in https://github.com/askama-rs/askama/pull/277|fmt and |format available with feature "alloc", but without "std" by @Kijewski in https://github.com/askama-rs/askama/pull/319enums, let Self refer to the original type by @Kijewski in https://github.com/askama-rs/askama/pull/333rinja path by @Kijewski in https://github.com/askama-rs/askama/pull/334Values for all collection types by @Kijewski in https://github.com/askama-rs/askama/pull/346askama_escaped by @Kijewski in https://github.com/askama-rs/askama/pull/378Removed features:
EXTENSION constant from Template by @Kijewski in https://github.com/askama-rs/askama/pull/252MIME_TYPE guessing by @Kijewski in https://github.com/askama-rs/askama/pull/271gen to keywords by @Kijewski in https://github.com/askama-rs/askama/pull/294Performance:
fmt::Formatter machinery in URL encoding by @Kijewski in https://github.com/askama-rs/askama/pull/218String if we can help it by @Kijewski in https://github.com/askama-rs/askama/pull/235WithSpan to one register by @Kijewski in https://github.com/askama-rs/askama/pull/257format!(), shorter context on error by @Kijewski in https://github.com/askama-rs/askama/pull/276serde and serde_derive by @Kijewski in https://github.com/askama-rs/askama/pull/343Safety and correctness:
unions as they require unsafe code by @Kijewski in https://github.com/askama-rs/askama/pull/231__rinja and free name writer by @Kijewski in https://github.com/askama-rs/askama/pull/292if let by @Kijewski in https://github.com/askama-rs/askama/pull/332from_utf8_unsafe() with AsciiStr by @Kijewski in https://github.com/askama-rs/askama/pull/351syn version by @paolobarbolini in https://github.com/askama-rs/askama/pull/379Documentation, our book, and examples:
upgrading.md by @Kijewski in https://github.com/askama-rs/askama/pull/303blocks by @Kijewski in https://github.com/askama-rs/askama/pull/340askama_web by @Kijewski in https://github.com/askama-rs/askama/pull/369Escaper argument fmt into dest by @Kijewski in https://github.com/askama-rs/askama/pull/349Testing:
Cluster-Fuzz by @Kijewski in https://github.com/askama-rs/askama/pull/376Migrate to from nom to winnow
input state by @epage in https://github.com/askama-rs/askama/pull/275Refactoring, error messages, and changes invisible to the user:
#[template] parsing by @Kijewski in https://github.com/askama-rs/askama/pull/243proc-macro support by @Kijewski in https://github.com/askama-rs/askama/pull/268enum variants by @Kijewski in https://github.com/askama-rs/askama/pull/266write_header() by @Kijewski in https://github.com/askama-rs/askama/pull/274uppercase and urlencode by @Kijewski in https://github.com/askama-rs/askama/pull/287file_info in find_template by @Kijewski in https://github.com/askama-rs/askama/pull/290block_in_include and add explanations on what is going on by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/279overflow_delimited_expr by @Kijewski in https://github.com/askama-rs/askama/pull/350Full Changelog: https://github.com/askama-rs/askama/compare/v0.3.5...v0.13.0
Update ui tests for rust 1.84, and deprecations in winnow 0.6.24 by @Kijewski in https://github.com/askama-rs/askama/pull/312
This pre-release, when compared to the last stable askama release (v0.12.1), consists of:
rinja into askama by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/353Major added and improved features:
enum variants by @Kijewski in https://github.com/askama-rs/askama/pull/255filesizeformat filter requirements by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/216blocks by @Kijewski in https://github.com/askama-rs/askama/pull/337~ by @Kijewski in https://github.com/askama-rs/askama/pull/236#![no_std] compatible by @Kijewski in https://github.com/askama-rs/askama/pull/286derive optional by @Kijewski in https://github.com/askama-rs/askama/pull/342More added and improved features:
FastWritable propagate custom errors by @Kijewski in https://github.com/askama-rs/askama/pull/217PrimitiveType for non-zero integers by @Kijewski in https://github.com/askama-rs/askama/pull/220AsIndent for NonZeroUsize and Wrapping<usize> by @Kijewski in https://github.com/askama-rs/askama/pull/221HtmlSafe for all reference wrappers by @Kijewski in https://github.com/askama-rs/askama/pull/219extends by @Kijewski in https://github.com/askama-rs/askama/pull/241_ by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/244std::num::Saturating is stable since rust 1.74 by @Kijewski in https://github.com/askama-rs/askama/pull/270Errors a bit easier by @Kijewski in https://github.com/askama-rs/askama/pull/277|fmt and |format available with feature "alloc", but without "std" by @Kijewski in https://github.com/askama-rs/askama/pull/319enums, let Self refer to the original type by @Kijewski in https://github.com/askama-rs/askama/pull/333rinja path by @Kijewski in https://github.com/askama-rs/askama/pull/334Values for all collection types by @Kijewski in https://github.com/askama-rs/askama/pull/346Removed features:
EXTENSION constant from Template by @Kijewski in https://github.com/askama-rs/askama/pull/252MIME_TYPE guessing by @Kijewski in https://github.com/askama-rs/askama/pull/271gen to keywords by @Kijewski in https://github.com/askama-rs/askama/pull/294Performance:
fmt::Formatter machinery in URL encoding by @Kijewski in https://github.com/askama-rs/askama/pull/218String if we can help it by @Kijewski in https://github.com/askama-rs/askama/pull/235WithSpan to one register by @Kijewski in https://github.com/askama-rs/askama/pull/257format!(), shorter context on error by @Kijewski in https://github.com/askama-rs/askama/pull/276serde and serde_derive by @Kijewski in https://github.com/askama-rs/askama/pull/343Safety and correctness:
unions as they require unsafe code by @Kijewski in https://github.com/askama-rs/askama/pull/231__rinja and free name writer by @Kijewski in https://github.com/askama-rs/askama/pull/292if let by @Kijewski in https://github.com/askama-rs/askama/pull/332from_utf8_unsafe() with AsciiStr by @Kijewski in https://github.com/askama-rs/askama/pull/351Documentation, our book, and examples:
upgrading.md by @Kijewski in https://github.com/askama-rs/askama/pull/303blocks by @Kijewski in https://github.com/askama-rs/askama/pull/340askama_web by @Kijewski in https://github.com/askama-rs/askama/pull/369Escaper argument fmt into dest by @Kijewski in https://github.com/askama-rs/askama/pull/349Testing:
Migrate to from nom to winnow
input state by @epage in https://github.com/askama-rs/askama/pull/275Refactoring, error messages, and changes invisible to the user:
#[template] parsing by @Kijewski in https://github.com/askama-rs/askama/pull/243proc-macro support by @Kijewski in https://github.com/askama-rs/askama/pull/268enum variants by @Kijewski in https://github.com/askama-rs/askama/pull/266write_header() by @Kijewski in https://github.com/askama-rs/askama/pull/274uppercase and urlencode by @Kijewski in https://github.com/askama-rs/askama/pull/287file_info in find_template by @Kijewski in https://github.com/askama-rs/askama/pull/290block_in_include and add explanations on what is going on by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/279overflow_delimited_expr by @Kijewski in https://github.com/askama-rs/askama/pull/350Full Changelog: https://github.com/askama-rs/askama/compare/v0.3.5...v0.13.0-pre.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add newly added f16 and f128 types in parsing by @GuillaumeGomez in https://github.com/rinja-rs/rinja/pull/82
is (not) defined feature by @GuillaumeGomez in https://github.com/rinja-rs/rinja/pull/78fmt::Formatters by @Kijewski in https://github.com/rinja-rs/rinja/pull/86cfg(feature = "__standalone") warnings by @Kijewski in https://github.com/rinja-rs/rinja/pull/89as in template language by @Kijewski in https://github.com/rinja-rs/rinja/pull/63memchr to speed-up skip_till() by @Kijewski in https://github.com/rinja-rs/rinja/pull/90as keyword by @GuillaumeGomez in https://github.com/rinja-rs/rinja/pull/99Full Changelog: https://github.com/rinja-rs/rinja/compare/v0.2.0...v0.3.0
Better (post-parser) errors by @GuillaumeGomez in https://github.com/rinja-rs/rinja/pull/1
indent information from Buffer by @GuillaumeGomez in https://github.com/rinja-rs/rinja/pull/4std::fmt::Error in rinja::Error by @Kijewski in https://github.com/rinja-rs/rinja/pull/17feature(doc_auto_cfg) and --generate-link-to-definition by @Kijewski in https://github.com/rinja-rs/rinja/pull/22|filter operator by @Kijewski in https://github.com/rinja-rs/rinja/pull/18.. in let pattern matching for structs (alternative take) by @Kijewski in https://github.com/rinja-rs/rinja/pull/36* and & in expressions by @GuillaumeGomez in https://github.com/rinja-rs/rinja/pull/39as_ref filter into ref by @GuillaumeGomez in https://github.com/rinja-rs/rinja/pull/40strip_common test was failing by @softdevca in https://github.com/rinja-rs/rinja/pull/44let to move variables by @GuillaumeGomez in https://github.com/rinja-rs/rinja/pull/43.rustfmt.toml configuration by @Kijewski in https://github.com/rinja-rs/rinja/pull/45#[allow(clippy::match_wild_err_arm)] and dedup error message creation by @Kijewski in https://github.com/rinja-rs/rinja/pull/46rinja_escape and make |escape a "normal" filter by @Kijewski in https://github.com/rinja-rs/rinja/pull/53#[derive(Template)] comment to the macro itself by @Kijewski in https://github.com/rinja-rs/rinja/pull/60typos to fix typos by @Kijewski in https://github.com/rinja-rs/rinja/pull/68.to_string() by @Kijewski in https://github.com/rinja-rs/rinja/pull/75testing/Cargo.toml by @GuillaumeGomez in https://github.com/rinja-rs/rinja/pull/76{% filter %} block by @Kijewski in https://github.com/rinja-rs/rinja/pull/73|linebreaks and friends by @Kijewski in https://github.com/rinja-rs/rinja/pull/77Full Changelog: Askama v0.12.1 ... Rinja v0.2.0
Nothing published for this version
One column per quarter.