11ty

Eleventy Documentation

This is an older version of Eleventy. Full release history. Go to the newest Eleventy docs. You could try /docs/filters/url/ although it may not exist.

Documentation Pages

url Universal Filter #

Works with the pathPrefix configuration option to properly normalize absolute paths in your content with the pathPrefix added. Useful if you host your site on GitHub Pages, which normally live in a subdirectory, e.g. https://11ty.github.io/eleventy-base-blog/. We set pathPrefix: "/eleventy-base-blog/" and our absolute links all have this prepended to the beginning.

If you don’t need pathPrefix (or don’t ever plan on moving your site’s top-level directory structure), you probably don’t need to use the url filter.

<a href="{{ post.url | url }}">Liquid or Nunjucks Link</a>
Sample URL Transformations
Sample URLpathPrefixReturn value
'''/''.' ⚠️ This style is probably not what you want—careful!
'/''/''/'
'./''/''./'
'..''/''..'
'myDir''/''myDir' ⚠️ This style is not safe for globally linking to other content. Be careful!
'/myDir''/''/myDir'
'./myDir''/''myDir' ⚠️ This style is not safe for globally linking to other content. Be careful!
'../myDir''/''../myDir'
Sample URLpathPrefixReturn value
'''/rootDir''.' ⚠️ This style is probably not what you want—careful!
'/''/rootDir''/rootDir/'
'./''/rootDir''./'
'..''/rootDir''..'
'myDir''/rootDir''myDir' ⚠️ This style is probably not what you want—careful!
'/myDir''/rootDir''/rootDir/myDir'
'./myDir''/rootDir''myDir' ⚠️ This style is probably not what you want—careful!
'../myDir''/rootDir''../myDir'