hugo/docs/content/en/methods/page/Sitemap.md
2024-08-09 15:17:43 +02:00

2.2 KiB

title description categories keywords action toc
Sitemap Returns the sitemap settings for the given page as defined in front matter, falling back to the sitemap settings as defined in the site configuration.
related returnType signatures
config.SitemapConfig
PAGE.Sitemap
true

Access to the Sitemap method on a Page object is restricted to sitemap templates.

Methods

changefreq
(string) How frequently a page is likely to change. Valid values are always, hourly, daily, weekly, monthly, yearly, and never. With the default value of "" Hugo will omit this field from the sitemap. See details.
{{ .Sitemap.ChangeFreq }}
disable {{< new-in 0.125.0 >}}
(bool) Whether to disable page inclusion. Default is false. Set to true in front matter to exclude the page.
{{ .Sitemap.Disable }}
priority
(float) The priority of a page relative to any other page on the site. Valid values range from 0.0 to 1.0. With the default value of -1 Hugo will omit this field from the sitemap. See details.
{{ .Sitemap.Priority }}

Example

With this site configuration:

{{< code-toggle file=hugo >}} [sitemap] changeFreq = 'monthly' {{< /code-toggle >}}

And this content:

{{< code-toggle file=content/news.md fm=true >}} title = 'News' [sitemap] changeFreq = 'hourly' {{< /code-toggle >}}

And this simplistic sitemap template:

{{< code file=layouts/_default/sitemap.xml >}} {{ printf "" | safeHTML }} {{ range .Pages }} {{ .Permalink }} {{ if not .Lastmod.IsZero }} {{ .Lastmod.Format "2006-01-02T15:04:05-07:00" | safeHTML }} {{ end }} {{ with .Sitemap.ChangeFreq }} {{ . }} {{ end }} {{ end }} {{< /code >}}

The change frequency will be hourly for the news page, and monthly for other pages.