Developer Documentation

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

Publii renders its themes using Handlebars, which offers great flexibility and opportunities to create diverse pages on your website.

We recommend newcomers start with the How to install a new theme in the Publii tutorial and then our Handlebars introduction. Both will ground them in the basics of Publii theming.

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

The reference sections cover Handlebars tags, helpers, global variables, partials and the Theme settings API. To see what happens during a build, read How the theme is rendered? and How images work in Publii.

Blank Theme

For users who want an easy way to start building a Publii theme, you can try out the blank theme included with the main package; it's the perfect way to start your Publii theme development adventure!


Download GitHub

Guides

Guides explain in-depth various aspects of building and working the Publii's theme.


Browse guides

Tutorials

In this section, you will find many articles covering the additional features available in Publii.


Browse tutorials

Recently Added

  1. {{#isNot}} helper
    Published:
  2. Image
    Published:
  3. {{#getPagesByCustomFields}} helper
    Published:
  4. {{#getPages}} helper
    Published:
  5. {{#getPage}} helper
    Published:
  6. Pages dropdown
    Published:

Recently Updated

  1. Handlebars - introduction
    Updated on:
  2. {{#isNot}} helper
    Updated on:
  3. Repeater
    Updated on:
  4. @website global variable
    Updated on:
  5. How to add pages support in Publii themes
    Updated on:
  6. Theme supported features
    Updated on:

Create your first website with Publii

Join thousands of creators who chose independence. Create content locally and publish lightning-fast, secure websites on your own terms.

Download Publii

Free and open source. Windows, macOS and Linux.

Read the getting started guide