hugo/docs/content/en/functions/ref.md

title	linktitle	description	godocref	date	publishdate	lastmod	categories	menu	keywords	signature	workson	hugoversion	relatedfuncs	deprecated	aliases
ref	ref	Looks up a content page by logical name.		2017-02-01	2017-02-01	2019-12-28	functions	docs parent functions	cross references anchors	ref . CONTENT			relref	false

ref and relref look up a content page by logical name (ref) or relative path (relref) to return the permalink:

{{ ref . "about.md" }}

{{% note "Usage Note" %}} ref looks up Hugo "Regular Pages" only. It can't be used for the homepage, section pages, etc. {{% /note %}}

It is also possible to pass additional arguments to link to another language or an alternative output format. Therefore, pass a map of arguments instead of just the path.

{{ ref . (dict "path" "about.md" "lang" "ja" "outputFormat" "rss") }} 

These functions are used in two of Hugo's built-in shortcodes. You can see basic usage examples of both ref and relref in the shortcode documentation.

For an extensive explanation of how to leverage ref and relref for content management, see Cross References.