NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #1448 most downloaded on crates.io
Parser for Askama templates
Latest stable
0.16.1
Last release 2 months ago
04 Sep 2026
Release timing varies
gaps range from 4 weeks to 1.2 years
Most releases are documented
notes for 12 of 15 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
16 releases · first in 2023
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
The main breaking change is about custom filters, they now require the filter_fn attribute. More information about it in the askama book.
The main breaking change is about custom filters, they now require the filter_fn attribute. More information about it in the askama book.
(❗ = breaking change)
reject filter❗ by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/430|default, |assigned_or and |defined_or❗ by @Kijewski in https://github.com/askama-rs/askama/pull/425askama::filter_fn proc-macro for custom filters with named/optional arg support❗ by @seijikun in https://github.com/askama-rs/askama/pull/545enum variants by @Kijewski in https://github.com/askama-rs/askama/pull/255[<element_expr>; <cnt_expr>] by @seijikun in https://github.com/askama-rs/askama/pull/626Improve error location to give better errors:
TokenStream rather than a String by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/558LocatingSlice<&str> instead of &str by @Kijewski in https://github.com/askama-rs/askama/pull/560Parser::[with_]span() to get byte range and use byte range for proc_macro::Span by @Kijewski in https://github.com/askama-rs/askama/pull/571filesizeformat with proper accuracy❗ by @seijikun in https://github.com/askama-rs/askama/pull/568linebreaks, paragraphbreaks and linebreaksbr only need core by @Kijewski in https://github.com/askama-rs/askama/pull/486ref documentation by @sinder38 in https://github.com/askama-rs/askama/pull/456performance.md by @zamazan4ik in https://github.com/askama-rs/askama/pull/188mdbook version and highlight jinja blocks by @Kijewski in https://github.com/askama-rs/askama/pull/544{# comment #} parsing by @Kijewski in https://github.com/askama-rs/askama/pull/488Expr::Attr into Expr::AssociatedItem by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/499Expr variants by @Kijewski in https://github.com/askama-rs/askama/pull/498|filter and {% filter %} parsing by @Kijewski in https://github.com/askama-rs/askama/pull/500if-let-chains by @Kijewski in https://github.com/askama-rs/askama/pull/527if-let by @Kijewski in https://github.com/askama-rs/askama/pull/532#[inline] annotations by @Kijewski in https://github.com/askama-rs/askama/pull/421indent Filter Implementation by @strickczq in https://github.com/askama-rs/askama/pull/466wordcount filter work with core only by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/480Expr::Call handling for {{ expressions }} and remove parentheses by @Kijewski in https://github.com/askama-rs/askama/pull/540Expr/Node with Box<Expr>/Box<Node> by @Kijewski in https://github.com/askama-rs/askama/pull/542punction() finding by @Kijewski in https://github.com/askama-rs/askama/pull/543loop.first is known by being at index == 0 by @Kijewski in https://github.com/askama-rs/askama/pull/436impl FastWritable for Cow by @C0D3-M4513R in https://github.com/askama-rs/askama/pull/432unicode-ident to determine what is an identifier by @Kijewski in https://github.com/askama-rs/askama/pull/443__askama by @Kijewski in https://github.com/askama-rs/askama/pull/444crate to be used as identifier by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/450LoopItem::index to LoopItem::index0 by @Kijewski in https://github.com/askama-rs/askama/pull/481U+10FFFF is the highest Unicode codepoint by @Kijewski in https://github.com/askama-rs/askama/pull/484{% raw %} and Lit::parse() without skip_till by @Kijewski in https://github.com/askama-rs/askama/pull/489{% raw %} for delimiters starting with - by @Kijewski in https://github.com/askama-rs/askama/pull/491suffix# by @Kijewski in https://github.com/askama-rs/askama/pull/496check_expr() recursion by @Kijewski in https://github.com/askama-rs/askama/pull/519EvaluatedResult know its unknown result by @Kijewski in https://github.com/askama-rs/askama/pull/538r#self is not a valid raw identifier in macro calls by @Kijewski in https://github.com/askama-rs/askama/pull/553:: by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/569lib.rs by @Kijewski in https://github.com/askama-rs/askama/pull/573r#_ is not a valid identifier by @Kijewski in https://github.com/askama-rs/askama/pull/579block calls are done by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/580safe filter in template_syntax.md by @FalkWoldmann in https://github.com/askama-rs/askama/pull/587syn stack overflow by @GuillaumeGomez in https://github.com/askama-rs/askama/pull/611Full Changelog: https://github.com/askama-rs/askama/compare/v0.14.0...v0.15.0
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
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
Nothing published for this version
One column per quarter.