Developer Documentation

These Developer Docs are for developers who work with Publii code, themes and addons.

If you're interested in creating a new theme or want to learn how to modify one of the existing Publii themes for your needs, then this is the right place for you!

Publii uses Handlebars to render its themes, which offers a large amount of flexibility and opportunities to create diverse pages on your website.

We recommend that newcomers start with the how to install a new theme in Publii tutorial followed by our Handlebars introduction, both of which will ground you in the basics of Publii theming.

If you are creating a custom theme, then both the articles on the theme config.json file and the theme structure will be useful.

For users that want an easy way to get started with building a Publii theme, you can try out the Starter theme included with the main package; this theme is specifically designed to be flexible and adaptable; the perfect way to start your Publii theme development adventure!

Download GitHub

It is also worth knowing how the Publii theme renderer works.

Every type of page available in Publii includes their tags. On every page, you can make use global variables and partials which are handy if you want to reuse your theme code.

We have extended the Handlebars API with many custom helpers which can help you to reduce the amount of code used in your theme.

In the tips and tricks section, you will find a lot of articles covering the additional features available in Publii- this article base is still growing, and we are excited to use it to share our knowledge with Publii theme developers.


Get the latest Publii news, updates and more delivered directly to your email inbox

You can change your mind at any time by clicking the unsubscribe link in the footer of any email you receive from us, or by contacting us at By clicking below, you agree that we may process your information in accordance with our Privacy Policy.