The liquid HTML file(s)

The only requirement for your theme is that you have a single file called ‘status-page.liquid’ which is basically an HTML file which contains the markup for your status page.

In addition, you can also include error-page.liquid which you can display to your users when your site is down. This usually contains a general notice, and can also display any notices from the status page should you wish.

So why the .liquid extension? We use the Liquid templating language from the clever folks at Shopify. This will allow you to control the dynamic content of your page.

The ‘includes’ folder

Sometimes your liquid layouts will become more complex, and you’ll find yourself duplicating code across various templates, which can feel a little messy. Put any snippets like this into the includes folder, and you can then reuse them with the liquid include tag

The ‘locales’ folder

This is how we provide multilingual support to your theme, and also allows people to personalize the content. In this folder you have a set of JSON files, one for each language you wish to support, containing a set of keys and the translated phrase.

The ‘assets’ folder

Whilst your theme needs nothing more than your liquid file to work, you can also include other assets such as stylesheets, images or JavaScript by dropping them directly into an ‘assets’ folder.

Important: The assets folder cannot contain subfolders.