1. Back
  2. Overview
  3. Creating Pages
    1. Editing Content
  4. Editing Templates
    1. Templating Language
    2. Assets
  5. Variable Types
    1. @variables
    2. $collections
    3. :partials
  6. RSS/Atom/JSON
  7. Download
    Version 2.0RC3


Partial templates separate out re-usable and repeatable blocks of html into their own files. They sit within the /templates/partials folder.

Stacey essentially flattens the folder structure within /templates/partials, so you can place your partial files within whatever subfolders make sense to you.

Partials can be referenced within a template by using a : followed by the filename of the partial template.

:images will be a reference to the /templates/partials/assets/images.html partial.

As with templates, partials do not need to be .html files. Stacey will recognise the following formats: .html, .json, .xml, .atom, .rss, .rdf & .txt

Partial Nesting

Partials references can also be nested within other partials. So, an example :media partial could contain:


if $images do
if $video do

Where :images & :video are references to other partial files.

Recursive Partials

Partials can also include references to themselves, allowing you to recurse through nested objects (ie, walking down a tree of $children).

A more elegant solution to the nested foreach loop example would be to split the code into two partials and take advantage of recursion within the :children partial.


<ol id="navigation">
  foreach $root do
    <li><a href="@url">@page_name</a> :children </li>


if $children do
    foreach $children do
      <li><a href="@url">@page_name</a> :children </li>