Skip to main content

Feed Support

About 1 minAdvancedAdvancedFeed

The theme adds feed support with @vuepress/plugin-feedopen in new window. To use it, install @vuepress/plugin-feed manually in your project.


vuepress-theme-hope provides plugins.feed in theme options to @vuepress/plugin-feed.

Enable Feed Output

The @vuepress/plugin-feed plugin can generate feed files in the following three formats for you:

  • Atom 1.0
  • JSON 1.1
  • RSS 2.0

Please use RSS if possible. Atom and JSON are only provided for best compatibility.

Please set plugins.feed.atom, plugins.feed.json or plugins.feed.rss to true in theme options according to the format you want to generate.


Of course, you can enable them all. This is not a "choose 1 from 3" situation.

Considering that rare people stick to feed now, this plugin provides a minimal configuration to adjust the automatic generation of detailed feed files. Also, it allows you to freely define the output content of the feed.

Channel Settings

You can customize the feed channel information by setting the in theme options.

We recommend the following settings:

  • Convert the date of creating the feed to ISOString and write it into channel.pubDate
  • The update period of the content set in channel.ttl (unit: minutes)
  • Set copyright information via channel.copyright, or fallback to copyright in theme options
  • Set the channel author via, or fallback to author in theme options

Default channel settings

  • The title and description of the channel is the name and description of the site by default

  • The link of the channel and the last update time will be automatically generated by the plugin.

For detailed options and their default values, see Feed Channel Docsopen in new window.

Generation Control

By default, all articles are added to the feed stream.

You can control how feed item is generated in specific article by configuring the feed option in frontmatter, check Feed frontmatter Docsopen in new window for details.

You can take full control of feed items generation by configuring the plugins.feed.getter, check Feed Getter Docsopen in new window for details.

I18n Config

The plugin generates separate feeds for each language.

You can provide different settings for different languages via plugins.feed.locales.