Our new major release Thymeleaf 2.1 has been recently published. Have a look at what's new in 2.1.

20 January 2014: We have a new article! Thymeleaf Page Layouts, by Rafał Borowiec. This article explains the different possibilities for organizing the layout of pages in thymeleaf-based applications. Check it out!

23 December 2013: Thymeleaf 2.0.20 has been released. This is a bufixing release which also adds support for Spring 4.0 to the Thymeleaf 2.0.x release branch. New versions of the thymeleaf-testing and thymeleaf-extras-springsecurity3 libraries (2.0.x branch) have also been released in order to complete this Spring 4 support. Have a look at the release notes at the thymeleaf forums for more info.

What is Thymeleaf?

Thymeleaf is a Java library. It is an XML / XHTML / HTML5 template engine (extensible to other formats) that can work both in web and non-web environments. It is better suited for serving XHTML/HTML5 at the view layer of web applications, but it can process any XML file even in offline environments.

It provides an optional module for integration with Spring MVC, so that you can use it as a complete substitute of JSP in your applications made with this technology, even with HTML5.

The main goal of Thymeleaf is to provide an elegant and well-formed way of creating templates. Its Standard and SpringStandard dialects allow you to create powerful natural templates, that can be correctly displayed by browsers and therefore work also as static prototypes. You can also extend Thymeleaf by developing your own dialects.

For more detail, have a look at the complete list of features.

What does it look like?

It looks like this:

A quick look at this piece of code reveals internationalization expressions (#{...}), variable/model-attribute evaluation expressions (${...}) and even utility functions (#numbers.formatDecimal(...)). It also shows that this fragment of (X)HTML code can be perfectly displayed by a browser as a prototype, without being executed at all —something called a natural template.

But there's so much more: full (optional) Spring MVC integration - including form binding, property editors and validation messages -, XML validation artifacts, text/javascript inlining and an intelligent template cache system.

Again, for more detail have a look at the complete list of features.

How is it distributed?

Thymeleaf is Open Source Software, and it is distributed under the terms of the Apache License 2.0.

Where can I start learning about it?

You should start by reading the tutorials at the documentation page.

How can I keep updated about Thymeleaf?

One of the best ways to do it is to follow us on twitter, but you can also subscribe to our News and Announcements Forum.

Who is using this thing?

Have a look at our 'Who is using Thymeleaf?' page for some download figures and interesting user experiences.

Project Status

Thymeleaf is production-ready. Current stable version is 2.1.2.RELEASE.

Have a question?

Post it at our User Forum.