site/docs/permalinks
layout: docs
title: Permalinks
prev_section: templates
next_section: pagination
permalink: /docs/permalinks/
Jekyll supports a flexible way to build your site’s URLs. You can specify the
permalinks for your site through the Configuration or in 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
date.
Permalinks are constructed by creating a template URL where dynamic elements are
represented by colon-prefixed keywords. For example, the default date
permalink is defined as /:categories/:year/:month/:day/:title.html.
Template variables
year
Year from the Post’s filename
month
Month from the Post’s filename
i_month
Month from the Post’s filename without leading zeros.
day
Day from the Post’s filename
i_day
Day from the Post’s filename without leading zeros.
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 will ignore this.
Built-in permalink styles
date
/:categories/:year/:month/:day/:title.html
pretty
/:categories/:year/:month/:day/:title/
none
/:categories/:title.html
Permalink style examples
Given a post named: /2009-04-29-slap-chop.textile
None specified, or permalink: date
/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