Permalinks

Jekyll supports a flexible way to build your site’s URLs. You can specify the permalinks for your site through the Configuration or on the YAML Front Matter for each post. You’re free to choose one of the built-in styles to create your links or craft your own. The default style is always date.

Note that even with --auto enabled, making changes to the permalink setting while Jekyll is running will require you restart Jekyll before new permalink templates will take effect.

Template Variables

Variable	Description
year	Year from the post’s filename
month	Month from the post’s filename
day	Day from the post’s filename
title	Title from the post’s filename
categories	The specified categories for this post. Jekyll automatically parses out double slashes in the URLs, so if no categories are present, it basically ignores this.
i_month	Month from the post’s filename without leading zeros.
i_day	Day from the post’s filename without leading zeros.

Built-in styles

Name	Template
date	/:categories/:year/:month/:day/:title.html
pretty	/:categories/:year/:month/:day/:title/
none	/:categories/:title.html

Examples

Given a post named: /2009-04-29-slap-chop.textile

Setting	Result
None specified.	/2009/04/29/slap-chop.html
permalink: pretty	/2009/04/29/slap-chop/index.html
permalink: /:month-:day-:year/:title.html	/04-29-2009/slap-chop.html
permalink: /blog/:year/:month/:day/:title	/blog/2009/04/29/slap-chop/index.html