2017-08-10 11:18:22 -04:00
---
title: RSS Templates
linktitle: RSS Templates
description: Hugo ships with its own RSS 2.0 template that requires almost no configuration, or you can create your own RSS templates.
date: 2017-02-01
publishdate: 2017-02-01
lastmod: 2017-02-01
2018-01-31 05:07:47 -05:00
keywords: [rss, xml, templates]
2017-08-10 11:18:22 -04:00
categories: [templates]
menu:
docs:
parent: "templates"
weight: 150
weight: 150
sections_weight: 150
draft: false
toc: true
---
## RSS Template Lookup Order
2018-03-11 15:39:20 -04:00
See [Template Lookup Order ](/templates/lookup-order/ ) for the complete reference.
2017-08-10 11:18:22 -04:00
{{% note "Hugo Ships with an RSS Template" %}}
Hugo ships with its own [RSS 2.0 template ](#the-embedded-rss-xml ). The embedded template will be sufficient for most use cases.
{{% /note %}}
2017-09-28 11:20:10 -04:00
RSS pages are of the type `Page` and have all the [page variables ](/variables/page/ ) available to use in the templates.
2017-08-10 11:18:22 -04:00
### Section RSS
A [section’ `/<SECTION>/index.xml` (e.g., http://spf13.com/project/index.xml).
Hugo provides the ability for you to define any RSS type you wish and can have different RSS files for each section and taxonomy.
## Lookup Order for RSS Templates
2018-03-11 15:39:20 -04:00
The table below shows the RSS template lookup order for the different page kinds. The first listing shows the lookup order when running with a theme (`demoTheme`).
2017-08-10 11:18:22 -04:00
2018-03-11 15:39:20 -04:00
{{< datatable-filtered " output " " layouts " " OutputFormat = = RSS " " Example " " OutputFormat " " Suffix " " Template Lookup Order " > }}
2017-08-10 11:18:22 -04:00
## Configure RSS
By default, Hugo will create an unlimited number of RSS entries. You can limit the number of articles included in the built-in RSS templates by assigning a numeric value to `rssLimit:` field in your project's [`config` file][config].
The following values will also be included in the RSS output if specified in your site’
2018-03-11 15:39:20 -04:00
```toml
2017-08-10 11:18:22 -04:00
languageCode = "en-us"
copyright = "This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License."
[author]
name = "My Name Here"
```
## The Embedded rss.xml
This is the default RSS template that ships with Hugo. It adheres to the [RSS 2.0 Specification][RSS 2.0].
2018-03-11 15:39:20 -04:00
```xml
2017-08-10 11:18:22 -04:00
< rss version = "2.0" xmlns:atom = "http://www.w3.org/2005/Atom" >
< channel >
< title > {{ if eq .Title .Site.Title }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{.}} on {{ end }}{{ .Site.Title }}{{ end }}< / title >
< link > {{ .Permalink }}< / link >
< description > Recent content {{ if ne .Title .Site.Title }}{{ with .Title }}in {{.}} {{ end }}{{ end }}on {{ .Site.Title }}< / description >
< generator > Hugo -- gohugo.io< / generator > {{ with .Site.LanguageCode }}
< language > {{.}}< / language > {{end}}{{ with .Site.Author.email }}
< managingEditor > {{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}< / managingEditor > {{end}}{{ with .Site.Author.email }}
< webMaster > {{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}< / webMaster > {{end}}{{ with .Site.Copyright }}
< copyright > {{.}}< / copyright > {{end}}{{ if not .Date.IsZero }}
< lastBuildDate > {{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}< / lastBuildDate > {{ end }}
{{ with .OutputFormats.Get "RSS" }}
{{ printf "< atom:link href = %q rel = \"self \" type = %q /> " .Permalink .MediaType | safeHTML }}
{{ end }}
2018-07-18 05:04:57 -04:00
{{ range .Pages }}
2017-08-10 11:18:22 -04:00
< item >
< title > {{ .Title }}< / title >
< link > {{ .Permalink }}< / link >
< pubDate > {{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}< / pubDate >
{{ with .Site.Author.email }}< author > {{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}< / author > {{end}}
< guid > {{ .Permalink }}< / guid >
< description > {{ .Summary | html }}< / description >
< / item >
{{ end }}
< / channel >
< / rss >
```
{{% warning "XML Header" %}}
Hugo will automatically add the following header line to this file on render. Please do *not* include this in the template as it's not valid HTML.
```
<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
```
{{% /warning %}}
## Reference your RSS Feed in `<head>`
2018-03-11 15:39:20 -04:00
In your `header.html` template, you can specify your RSS feed in your `<head></head>` tag using Hugo's [Output Formats][Output Formats] like this:
2017-08-10 11:18:22 -04:00
2018-05-04 03:44:21 -04:00
```go-html-template
2018-03-11 15:39:20 -04:00
{{ range .AlternativeOutputFormats -}}
2018-08-08 07:54:28 -04:00
{{ printf `<link rel="%s" type="%s" href="%s" title="%s" />` .Rel .MediaType.Type .Permalink $.Site.Title | safeHTML }}
2018-03-11 15:39:20 -04:00
{{ end -}}
2017-08-10 11:18:22 -04:00
```
2018-05-04 03:44:21 -04:00
If you only want the RSS link, you can query the formats:
2017-08-10 11:18:22 -04:00
2018-05-04 03:44:21 -04:00
```go-html-template
2018-03-11 15:39:20 -04:00
{{ with .OutputFormats.Get "rss" -}}
2018-08-08 07:54:28 -04:00
{{ printf `<link rel="%s" type="%s" href="%s" title="%s" />` .Rel .MediaType.Type .Permalink $.Site.Title | safeHTML }}
2018-05-04 03:44:21 -04:00
{{ end -}}
```
Either of the two snippets above will generate the below `link` tag on the site homepage for RSS output:
```html
< link rel = "alternate" type = "application/rss+xml" href = "https://example.com/index.xml" title = "Site Title" >
2017-08-10 11:18:22 -04:00
```
2018-05-04 03:44:21 -04:00
_We are assuming `BaseURL` to be `https://example.com/` and `$.Site.Title` to be `"Site Title"` in this example._
2017-08-10 11:18:22 -04:00
[config]: /getting-started/configuration/
[embedded]: #the -embedded-rss-xml
[RSS 2.0]: http://cyber.law.harvard.edu/rss/rss.html "RSS 2.0 Specification"
[section]: /content-management/sections/
2018-05-04 03:44:21 -04:00
[Output Formats]: /templates/output-formats/#link-to-output-formats
