hugo/docs/content/en/templates/sitemap-template.md
2023-05-22 16:47:07 +02:00

2.8 KiB

title description categories keywords menu weight aliases toc
Sitemap Templates Hugo provides built-in sitemap templates.
templates
sitemap
xml
templates
docs
parent weight
templates 160
160
/layout/sitemap/
/templates/sitemap/
true

Overview

Hugo's built-in sitemap templates conform to v0.9 of the sitemap protocol.

With a monolingual project, Hugo generates a sitemap.xml file in the root of the publishDir using the built-in sitemap.xml template.

With a multilingual project, Hugo generates:

  • A sitemap.xml file in the root of each site (language) using the built-in sitemap.xml template
  • A sitemap.xml file in the root of the publishDir using the built-in sitemapindex.xml template

Configuration

Set the default values for change frequency and priority, and the name of the generated file, in your site configuration.

{{< code-toggle file="config" >}} [sitemap] changefreq = 'monthly' filename = 'sitemap.xml' priority = 0.5 {{</ code-toggle >}}

changefreq
How frequently a page is likely to change. Valid values are always, hourly, daily, weekly, monthly, yearly, and never. Default is "" (change frequency omitted from rendered sitemap).
filename
The name of the generated file. Default is sitemap.xml.
priority
The priority of a page relative to any other page on the site. Valid values range from 0.0 to 1.0. Default is -1 (priority omitted from rendered sitemap).

Override Default Values

Override the default values for a given page in front matter.

{{< code-toggle file="news.md" fm=true >}} title = 'News' [sitemap] changefreq = 'weekly' priority = 0.8 {{</ code-toggle >}}

Override Built-in Templates

To override the built-in sitemap.xml template, create a new file in either of these locations:

  • layouts/sitemap.xml
  • layouts/_default/sitemap.xml

When ranging through the page collection, access the change frequency and priority with .Sitemap.ChangeFreq and .Sitemap.Priority respectively.

To override the built-in sitemapindex.xml template, create a new file in either of these locations:

  • layouts/sitemapindex.xml
  • layouts/_default/sitemapindex.xml

Disable Sitemap Generation

You may disable sitemap generation in your site configuration:

{{< code-toggle file="config" >}} disableKinds = ['sitemap'] {{</ code-toggle >}}