hugo/docs/content/extras/aliases.md
Noah Campbell c75da346e1 Fix alias documentation.
Fixes #79
2013-09-13 16:06:39 -07:00

867 B

title date aliases
Aliases 2013-07-09
/doc/redirects/
/doc/alias/
/doc/aliases/

For people migrating existing published content to Hugo theres a good chance you need a mechanism to handle redirecting old urls.

Luckily, this can be handled easily with aliases in Hugo.

Example

content/posts/my-awesome-blog-post.md

---
aliases:
    - /posts/my-original-url/
    - /2010/even-earlier-url.html
---

Now when you go to any of the aliases locations they will redirect to the page.

Important Behaviors

  1. Hugo makes no assumptions about aliases. They also don't change based on your UglyUrls setting. You need to provide absolute path to your webroot and the complete filename or directory.

  2. Aliases are rendered prior to any content and will be overwritten by any content with the same location.