Template Data

Jekyll traverses your site looking for files to process. Any files with YAML Front Matter are subject to processing. For each of these files, Jekyll makes a variety of data available to the pages via the Liquid templating system. The following is a reference of the available data.

Global

Variable	Description
site	Sitewide information + Configuration settings from _config.yml
page	For Posts, this is the union of the data in the YAML Front Matter and the computed data (such as URL and date). For regular pages, this is just the YAML Front Matter.
content	In layout files, this contains the content of the subview(s). In Posts or Pages, this is undefined.
paginator	When the paginate configuration option is set, this variable becomes available for use.

Site

Variable	Description
site.time	The current Time (when you run the jekyll command).
site.posts	A reverse chronological list of all Posts.
site.related_posts	If the page being processed is a Post, this contains a list of up to ten related Posts. By default, these are low quality but fast to compute. For high quality but slow to compute results, run the jekyll command with the --lsi (latent semantic indexing) option.
site.categories.CATEGORY	The list of all Posts in category CATEGORY.
site.[CONFIGURATION_DATA]	As of 0.5.2, all data inside of your _config.yml is now available through the site variable. So for example, if you have url: http://mysite.com in your configuration file, then in your posts and pages it can be used like so: {{ site.url }}

Post

Variable	Description
post.title	The title of the Post.
post.url	The URL of the Post without the domain. e.g. /2008/12/14/my-post.html
post.date	The Date assigned to the Post.
post.id	An identifier unique to the Post (useful in RSS feeds). e.g. /2008/12/14/my-post
post.categories	The list of categories to which this post belongs. Categories are derived from the directory structure above the posts directory. For example, a post at @/work/code/posts/2008-12-24-closures.textile@ would have this field set to ['work', 'code']. These can also be specified in the YAML Front Matter
post.topics	The list of topics for this Post. Topics are derived from the directory structure beneath the posts directory. For example, a post at @/posts/music/metal/2008-12-24-metalocalypse.textile@ would have this field set to ['music', 'metal'].
post.content	The content of the Post.

Paginator

Variable	Description
paginator.per_page	Number of posts per page.
paginator.posts	Posts available for that page.
paginator.total_posts	Total number of posts.
paginator.total_pages	Total number of pages.
paginator.previous_page	The number of the previous page.
paginator.next_page	The number of the next page.