Skip to content


Subversion checkout URL

You can clone with
Download ZIP


davecranwell edited this page · 35 revisions

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

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


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
Something went wrong with that request. Please try again.