ec920363cd
4c5edacfe cSpell config update (#1700) 9df788b25 Fix broken link (hugo modules) (#1710) 9928a70d6 Fix workspace formatting (#1707) 55467e7c8 Update partials.md 9f4bd0023 Update formats.md 9b3913c86 Remove footnoteAnchorPrefix and footnoteReturnLinkContents (#1704) 94502a09b Code block render hooks are introduced in v0.93.0 (#1701) c447270ef Update sitemap-template.md 78665c1e0 Update sitemap-template.md 60653c17d Update the caddy error docs link (#1696) 9a3675aad Update sitemap templates (#1699) e0d08cdbb Add wpxr-to-static to list of migration tools (#1512) b53eb5a08 Add page for deploying with rclone (#1511) 4207c57ff netlify: Hugo 0.96.0 a18d646ea docs: Regen docshelper e3e0981ed docs: Regen CLI docs fda988d01 Merge commit 'd276e901b36d2576ef8350ed96b17f66254eac1b' e4a26dbca tpl/crypto: Add optional encoding arg to hmac function git-subtree-dir: docs git-subtree-split: 4c5edacfeebd13eb7f876723c065466cd50e0cae
2.9 KiB
| title | description | date | categories | keywords | menu | weight | sections_weight | draft | aliases | toc | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Sitemap Templates | Hugo provides built-in sitemap templates. | 2017-02-01 |
|
|
|
160 | 160 | false |
|
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, andnever. 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 >}}
[publishDir]: {{< relref "getting-started/configuration#publishdir" >}}
[change frequency]: https://www.sitemaps.org/protocol.html#changefreqdef
[priority]: https://www.sitemaps.org/protocol.html#priority
[sitemap protocol]: https://www.sitemaps.org/protocol.html
[sitemap.xml]: https://github.com/gohugoio/hugo/blob/master/tpl/tplimpl/embedded/templates/_default/sitemap.xml
[sitemapindex.xml]: https://github.com/gohugoio/hugo/blob/master/tpl/tplimpl/embedded/templates/_default/sitemapindex.xml