Breaking change Prior to v0.155.0 , alias paths beginning with a slash (/) were treated as server-relative . In v0.155.0 and later, they are now site-relative . This change only affects multilingual single-host projects that used alias paths beginning with a slash (/) to cross language boundaries. For…

Amazing work on the docs (and Hugo)! :raising_hands:t2: :tada: And thanks for this post. Questions Q. Is there a semantic distinction between foo and ./foo? I’m asking because I’ve found it useful to distinguish between them for index pages, for example: content/en/docs/collector/_index.md --- …

[image] chalin: Is there a semantic distinction between foo and ./foo? Hugo interprets those paths in the same way that your OS does; there is no difference between foo and ./foo. Interpreting those differently would be confusing, unexpected, and a departure from the universal standards of pa…

[image] jmooring: Unless I’m missing something, we already do. Try it: Very cool test project! Thanks for putting that together. Hmm, has markdown link resolution always worked like this? (I think not, but I might have been mistaken) Anyhow, I’m glad it works that way (now)! [image] jmoo…

[image] chalin: has markdown link resolution always worked like this? If you are asking, “Have Hugo’s embedded link and render hooks always resolved link destinations like this?”, then the answer is yes.

[image] jmooring: “Have Hugo’s embedded link and render hooks always resolved link destinations like this?”, then the answer is yes. Wow, then I’ve had quite a misconception about this for a while! :sweat_smile: Thanks for helping me clarify that.

Alias paths in v0.155.0 and later

tips & tricks

jmooring Split this topic February 24, 2026, 4:03pm 7

A post was split to a new topic: Help with server-relative aliases

Topic		Replies	Views
How to use aliases across languages in v0.155.0? support aliases	9	132	February 7, 2026
Alias redirect issues with a "sub-domain" base URL support	4	1462	February 18, 2018
Aliases on root across languages in v0.155.0? support i18n , aliases	9	79	April 2, 2026
Have Aliases stopped working for anyone else? support	5	615	February 24, 2023
Latest Hugo broke all my site aliases support	3	956	June 12, 2016

Alias paths in v0.155.0 and later

Related topics