Skip to content

Latest commit

 

History

History
78 lines (49 loc) · 2.13 KB

plugin-sitemap.md

File metadata and controls

78 lines (49 loc) · 2.13 KB
sidebar_position slug
10
/api/plugins/@docusaurus/plugin-sitemap

📦 plugin-sitemap

import APITable from '@site/src/components/APITable';

This plugin creates sitemaps for your site so that search engine crawlers can crawl your site more accurately.

:::caution production only

This plugin is always inactive in development and only active in production because it works on the build output.

:::

Installation {#installation}

npm install --save @docusaurus/plugin-sitemap

:::tip

If you use the preset @docusaurus/preset-classic, you don't need to install this plugin as a dependency.

You can configure this plugin through the preset options.

:::

Configuration {#configuration}

Accepted fields:

Name Type Default Description
changefreq string 'weekly' See sitemap docs
priority number 0.5 See sitemap docs
ignorePatterns string[] [] A list of glob patterns; matching route paths will be filtered from the sitemap. Note that you may need to include the base URL in here.
filename string sitemap.xml The path to the created sitemap file, relative to the output directory. Useful if you have two plugin instances outputting two files.

:::info

This plugin also respects some site config:

  • noIndex: results in no sitemap generated
  • trailingSlash: determines if the URLs in the sitemap have trailing slashes

:::

Example configuration {#ex-config}

You can configure this plugin through preset options or plugin options.

:::tip

Most Docusaurus users configure this plugin through the preset options.

:::

// Preset Options: sitemap
// Plugin Options: @docusaurus/plugin-sitemap

const config = {
  changefreq: 'weekly',
  priority: 0.5,
  ignorePatterns: ['/tags/**'],
  filename: 'sitemap.xml',
};

You can find your sitemap at /sitemap.xml.