Reference

The URL to your profile picture, or avatar, uploaded on the Photo page of your dashboard

<img src="{{{blog.avatar}}}" />

A list of links on your site's menu, added on the Links page of your site's dashboard and pages. Each item in the list has the following properties:

id string
Unique identiﬁer for this link
label string
Text label for this link
url string
URL for this link
metadata object
The metadata set for the page which generated this link.
active boolean
true if you are currently looking at this link
first boolean
true if this link is the first in your menu
penultimate boolean
true if this link is the penultimate link in your menu
last boolean
true if this link is the last in your menu

{{#blog.menu}}
<a href="{{url}}">{{label}}</a>
{{/blog.menu}}

cacheID

A datestamp for when your site was last updated

timezone

Your site’s timezone in the tz database format

cssURL

Path to your site’s stylesheet. It contains a query string for cache-invalidation.

scriptURL

Path to your site’s JavaScript file. It contains a query string for cache-invalidation.

roundAvatar

true if you’ve indicated your avatar is round, false if not

entry

id

Alias for the path property, which uniquely identiﬁes the post.

guid

Globally unique alpha-numeric identiﬁer for the post.

path

The file’s path, with the blog’s folder as root.

absoluteURL

The full-qualified URL to the post

date

The blog post’s publication date, as a human-readable string

dateStamp

The blog post’s publication date, as a unix timestamp.

backlinks

A list of all the entries on your site which link to this entry. Each item in the list is an entry.

{{#backlinks}}
<a href="{{url}}">{{title}}</a>
{{/backlinks}}

formatDate

Used to format the entry's publication date as you like, using any of the supported date tokens.

{{#formatDate}}
MMMM DDDo, YYYY 
{{/formatDate}}

formatUpdated

Used to format the entry's updated date as you like, using any of the supported date tokens.

{{#formatUpdated}}
MMMM DDDo, YYYY 
{{/formatUpdated}}

formatCreated

Used to format the entry's created date as you like, using any of the supported date tokens.

{{#formatCreated}}
MMMM DDDo, YYYY 
{{/formatCreated}}

thumbnail

object

object containing the thumbnails for the entry, if they exist. Blot will not increase the size of smaller images. The JSON added to each entry looks something like this

small object
which has a width and height under 160px.
medium object
the default, which has a width under 640px.
large object
which has a width and height under 1060px.
square object
which has a width and height of 160px.

{{#thumbnail.medium}}
  <img src="{{#cdn}}{{url}}
       width="{{width}}" 
       height="{{height}}"/>
{{/thumbnail.medium}}

metadata

object

object containing the metadata for the entry, if they exist.

name

The file’s name, preserving the case where possible.

created

The file’s creation date, as a Unix timestamp.

updated

The file’s last-modiﬁed date, as a Unix timestamp.

summary

The text of the ﬁrst paragraph of the entry.

titleTag

If the post’s title was generated from a heading in the blog post, this property contains that heading’s HTML. For example: <h1>Your post's <em>nice</em> title</h1>

body

The HTML of the blog post, excluding the titleTag. This property is useful if you want to manipulate the HTML of the titles of your blog posts.

The HTML of the title and the ﬁrst few items in the entry. You can specify the end of the teaser by inserting the special tag {{more}} into your blog post's ﬁle. Everything before more will be included in the teaser.

teaserBody

The HTML of the ﬁrst few items in the entry, excluding the title. Equivalent to teaser without the titleTag.

A boolean value indicating if the post’s teaser property is different to its html property. This is useful for determining whether or not to show 'read more' links.

slug

The value of the metadata property permalink. Same as URL.

permalink

The value of the metadata property permalink. Same as URL.

index

The index of the entry in the list of all of your entries. For example, the ﬁrst entry published has an {{index}} of 1 and the 10th entry published has an {{index}} of 10.

“true” if the entry is a page on the menu, “false” if not

page

“true” if the entry is a page, “false” if not

deleted

“true” if the entry is deleted, “false” if not

draft

“true” if the entry is a draft, “false” if not

scheduled

“true” if the entry is scheduled for future publication, “false” if not

Lists of entries

recent_entries

A list of the 30 most recent entries on your site. Each item in the list is of type entry.

{{#recent_entries}}
<a href="{{url}}">{{title}}</a>
{{/recent_entries}}

all_entries

A list of all the entries on your site. Each item in the list is of type entry.

{{#all_entries}}
<a href="{{url}}">{{title}}</a>
{{/all_entries}}

Lists of tags

all_tags

A list of all the tags used on your site, sorted alphabetically by tag text.

tag string
The tag text
slug string
The tag text, in a URL-friendly form
entries array
A list of every entry with this tag in reverse-chronological order.
total number
The number of entries with this tag.

{{#all_tags}}
<a href="/tagged/{{slug}}">{{tag}}</a><br>
{{/all_tags}}

popular_tags

A list of all the tags used on your site, sorted by the number of entries with each tag.

tag string
The tag text
slug string
The tag text, in a URL-friendly form
entries array
A list of every entry with this tag in reverse-chronological order.
total number
The number of entries with this tag.

{{#popular_tags}}
<a href="/tagged/{{slug}}">{{tag}}</a><br>
{{/popular_tags}}

Utilities

absoluteURLs

The same contents, with any relative URLs fully resolved. This is useful to create an RSS feed, since many clients struggle with relative URLs. For example

{{#absoluteURLs}}
{{{html}}}
{{/absoluteURLs

encodeJSON

The same contents, encoded appropriately for JSON. This is useful to create a JSON feed. You can use it like this

{{#encodeJSON}}
{{{html}}}
{{/encodeJSON}}

encodeURIComponent

This is useful for forming urls from entry properties

?text={{#encodeURIComponent}}
{{title}}
{{/encodeURIComponent}}

encodeXML

The same contents, encoded appropriately for XML. This is useful to create a RSS feed. You can use it like this

{{#encodeXML}}
{{{html}}}
{{/encodeXML}}

rgb