gohugoio--hugo/docs/content/en/methods/menu-entry/PageRef.md

title, description, categories, keywords, params

title	description	categories	keywords	params
PageRef	Returns the `pageRef` property of the given menu entry.			functions_and_methods returnType signatures string MENUENTRY.PageRef

Note

The use case for this method is rare. In almost also scenarios you should use the URL method instead.

Explanation

If you specify a pageRef property when defining a menu entry in your project configuration, Hugo looks for a matching page when rendering the entry.

If a matching page is found:

• The URL method returns the page's relative permalink
• The Page method returns the corresponding Page object
• The HasMenuCurrent and IsMenuCurrent methods on a Page object return the expected values

If a matching page is not found:

• The URL method returns the entry's url property if set, else an empty string
• The Page method returns nil
• The HasMenuCurrent and IsMenuCurrent methods on a Page object return false

Note

In almost also scenarios you should use the URL method instead.

Example

This example is contrived.

Note

In almost also scenarios you should use the URL method instead.

Consider this content structure:

content/
├── products.md
└── _index.md

And this menu definition:

{{< code-toggle file=hugo >}} menus.main name = 'Products' pageRef = '/products' weight = 10 menus.main name = 'Services' pageRef = '/services' weight = 20 {{< /code-toggle >}}

With this template code:

<ul>
  {{ range .Site.Menus.main }}
    <li><a href="{{ .URL }}">{{ .Name }}</a></li>
  {{ end }}
</ul>

Hugo render this HTML:

<ul>
  <li><a href="/products/">Products</a></li>
  <li><a href="">Services</a></li>
</ul>

In the above note that the href attribute of the second anchor element is blank because Hugo was unable to find the services page.

With this template code:

<ul>
  {{ range .Site.Menus.main }}
    <li><a href="{{ or .URL .PageRef }}">{{ .Name }}</a></li>
  {{ end }}
</ul>

Hugo renders this HTML:

<ul>
  <li><a href="/products/">Products</a></li>
  <li><a href="/services">Services</a></li>
</ul>

In the above note that Hugo populates the href attribute of the second anchor element with the pageRef property as defined in your project configuration because the template code falls back to the PageRef method.